> ## 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](https://docs.plerion.com/guides/integrations/kubernetes/collector-manager/installation/helm-chart-options.md) 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.

**1. 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
```

**2. 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!⎈
```

**3. 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.

```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](https://docs.plerion.com/guides/integrations/kubernetes/collector-manager/installation/helm-chart-options.md). Note that unsetting the `priorityClass` may affect availability.

**4. Validate the installation**

After installation, complete these validation checks:

* [Validate Helm release](https://docs.plerion.com/guides/integrations/kubernetes/collector-manager/installation/installation-validation.md)
* [Ensure leader election](https://docs.plerion.com/guides/integrations/kubernetes/collector-manager/installation/ensuring-leader-election.md)


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