User Avatar

Installing the Komodor Agent

This guide walks you through installing the Komodor agent using Helm.

Prerequisites

  • A Kubernetes cluster
  • Helm installed and configured
  • Access to the Komodor platform and an API key

If you don’t have an API key, log in to Komodor and navigate to Settings > Agent Setup.

Step 1: Add the Komodor Helm Repository

helm repo add komodorio https://helm-charts.komodor.io


helm repo update

Step 2: Create a Namespace (Optional)

You can install the agent in a dedicated namespace:

kubectl create namespace komodor

Step 3: Install the Agent

Replace <YOUR_KOMODOR_API_KEY> with your actual API key.

helm upgrade --install komodor-agent komodorio/komodor-agent \


  --namespace komodor \


  --create-namespace \


  --set agent.apiKey=<YOUR_KOMODOR_API_KEY>

This command installs the Komodor agent into your cluster using the default configuration.

Step 4: Verify Installation

Check that the agent pod is running:

kubectl get pods -n komodor

You should see output similar to:

NAME                              READY   STATUS    RESTARTS   AGE
komodor-agent-xxxxx               1/1     Running   0          1m

Step 5: Confirm in the Komodor UI

Once the agent is running, go back to the Komodor dashboard. Your cluster should now be visible under the Clusters section.

If the cluster doesn't appear after a few minutes, double-check the API key and that the pod is in a Running state.