> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install collector manager

> Install Plerion's collector manager in your Kubernetes cluster using Helm and validate that it is running correctly.

## Prerequisites

* **Helm** version `>= 3.0.0`
* **Kubernetes cluster** version `v1.27.x` or later
* **Node architecture** `amd64` (x86-64) or `arm64`
* Active [Plerion Kubernetes integration](https://app.plerion.com/settings/integrations/Kubernetes/integration)

***

## Steps to install

<Note>
  You can use [advanced configuration options](/guides/integrations/kubernetes/collector-manager/installation/helm-chart-options) with this Helm chart.\
  Chart values can be set directly using the `--set` flag, as shown in the examples, or referenced from a `values.yaml` file for a more organized configuration.
</Note>

<Steps>
  <Step title="Add the Plerion Helm repository">
    Add Plerion's Helm charts to your configuration:

    ```shell theme={"system"}
    helm repo add plerion https://app.plerion.com/helm-charts
    ```

    **Example output**:

    ```
    "plerion" has been added to your repositories
    ```
  </Step>

  <Step title="Update available charts">
    Refresh the Helm repository to ensure you have the latest chart versions:

    ```shell theme={"system"}
    helm repo update
    ```

    **Example output**:

    ```
    Hang tight while we grab the latest from your chart repositories...
    ...Successfully got an update from the "plerion" chart repository
    Update Complete. ⎈Happy Helming!⎈
    ```
  </Step>

  <Step title="Install the collector manager">
    Run the following command to install the collector manager into the `plerion-system` namespace. Replace placeholder values with those provided during integration setup.

    <Warning>
      The integration setup in Plerion provides the exact values you need. Using incorrect values will prevent the collector manager from connecting to the Control Plane.
    </Warning>

    ```shell theme={"system"}
    export INTEGRATION_KEY="your-integration-key-here"
    helm install plerion-collector-manager plerion/collector-manager \\
      --namespace plerion-system --create-namespace \\
      --set collector.organizationId=[organizationId] \\
      --set collector.tenantId=[tenantId] \\
      --set collector.integrationId=[integrationId] \\
      --set collector.appUrl=[appUrl] \\
      --set collector.integrationKey=$INTEGRATION_KEY
    ```

    **Example output**:

    ```
    Update Complete. ⎈Happy Helming!⎈
    NAME: plerion-collector-manager
    LAST DEPLOYED: Mon Nov 20 18:52:18 2023
    NAMESPACE: plerion-system
    STATUS: deployed
    REVISION: 1
    ```

    <Warning>
      When using **Google Kubernetes Engine (GKE)**, you may encounter the following error: `insufficient quota to match these scopes: [{PriorityClass In [system-cluster-critical]}]`.

      This happens because the collector manager is assigned the highest scheduling priority (`system-cluster-critical`).

      To resolve this, request a quota increase or unset the `priorityClass` using [advanced options](/guides/integrations/kubernetes/collector-manager/installation/helm-chart-options). Note that unsetting the `priorityClass` may affect availability.
    </Warning>
  </Step>

  <Step title="Validate the installation">
    After installation, complete these validation checks:

    * [Validate Helm release](/guides/integrations/kubernetes/collector-manager/installation/installation-validation)
    * [Ensure leader election](/guides/integrations/kubernetes/collector-manager/installation/ensuring-leader-election)
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.