Connect a Cluster

1. Get your auth token

In the dashboard, go to Settings → Clusters → Connect cluster. Copy the auth token — it is unique to your organisation and valid for 60 minutes.

2. Install the Helm chart

helm install dataagent oci://ghcr.io/data-agent-co/dataagent-chart \
  --namespace dataagent \
  --create-namespace \
  --set config.authToken=<your-token> \
  --set config.clusterName=<your-cluster-name> \
  --set imageCredentials.password=<your-ghcr-pat>

Replace:

• <your-token> — the auth token from the dashboard
• <your-cluster-name> — a human-readable name shown in the dashboard (e.g. prod-eu-west-1)
• <your-ghcr-pat> — a GitHub PAT with read:packages scope, used to pull the agent image

3. Verify the agent is running

kubectl get pods -n dataagent

Expected output:

NAME                         READY   STATUS    RESTARTS   AGE
dataagent-7d9f8b6c4-xk2p9   4/4     Running   0          2m

All 4 containers should be Running: the orchestrator, K8sGPT sidecar, metrics collector, and topology analyzer.

4. Confirm connection in the dashboard

Go to Settings → Clusters. Your cluster should appear with a green Connected status within 60 seconds.

If the cluster does not appear after 2 minutes, check Agent not connecting.

Upgrading

helm upgrade dataagent oci://ghcr.io/data-agent-co/dataagent-chart \
  --namespace dataagent \
  --reset-then-reuse-values

Customising the installation

See the Helm chart reference for all available values.