Skip to main content
This guide covers installing the Chamber agent using Helm.
For a guided setup experience, use the installation wizard in the Chamber dashboard.
This guide installs only the Chamber agent on an existing Kubernetes cluster. To deploy a complete GPU-ready cluster (VPC, Kubernetes, GPU autoscaling, GPU drivers, and the Chamber agent), see Cluster Deployment.

​
Prerequisites

Before installing, ensure you have:
Verify with kubectl version. The agent supports Kubernetes 1.24 and later.
Verify with helm version. Install from helm.sh if needed.
Nodes must have NVIDIA drivers installed. Verify with nvidia-smi on GPU nodes.
The NVIDIA device plugin must be deployed. Verify:
kubectl get pods -n kube-system -l name=nvidia-device-plugin-ds
DCGM-Exporter is required for GPU metrics collection. Verify:
kubectl get pods -n gpu-operator -l app=nvidia-dcgm-exporter
If not installed, deploy via the NVIDIA GPU Operator or standalone:
helm repo add nvidia https://helm.ngc.nvidia.com/nvidia
helm install dcgm-exporter nvidia/dcgm-exporter -n gpu-operator --create-namespace
For the GPU Usage metric, DCGM profiling metrics must be enabled. See GPU Usage Metric Not Available for configuration steps.
Get this from the Chamber dashboard (see below).

​
Quick Install

# Install the agent (OCI registry - no helm repo add needed)
helm install chamber-agent oci://public.ecr.aws/chamber/chamber-agent-chart \
  --version 0.8.9 \
  --namespace chamber-system \
  --create-namespace \
  --set saas.url="wss://controlplane-api.usechamber.io/agent" \
  --set saas.token="<YOUR_TOKEN>" \
  --set saas.clusterId="your-gpu-cluster"
Your cluster will appear in the Chamber dashboard within 30 seconds.
Always specify --version to ensure reproducible deployments. Check the releases page for the latest version.

​
Getting a Cluster Token

1

Log in to Chamber

Go to app.usechamber.io and sign in.
2

Navigate to Settings

Click Settings in the sidebar, then Security tab.
3

New Token

Click New Token, give it a name, and copy immediately.
Store your token securely. It’s only shown once and cannot be retrieved later.

​
Verifying Installation

​
Check Pod Status

kubectl get pods -n chamber-system -l app.kubernetes.io/name=chamber-agent
Expected output: 
NAME                              READY   STATUS    RESTARTS   AGE
chamber-agent-5d4f6b7c8d-abc12    1/1     Running   0          30s

​
Check Logs

kubectl logs -n chamber-system -l app.kubernetes.io/name=chamber-agent --tail=20
Look for: 
INFO  WebSocket connected successfully
INFO  Metadata collected: 4 nodes, 32 GPUs

​
Check Version

helm list -n chamber-system
Shows the installed chart version and app version.

​
Verify in Dashboard

Within 30 seconds of installation:
  1. Go to app.usechamber.io
  2. Navigate to Capacity Pools
  3. Your cluster should appear with the correct GPU count
If GPUs show as 0, verify the NVIDIA device plugin is running and nodes have nvidia.com/gpu resources.

​
Network Requirements

The agent requires outbound HTTPS access to:
HostPortPurpose
controlplane-api.usechamber.io443Control plane communication
The agent only makes outbound connections. No inbound firewall rules are required.

​
Uninstalling

helm uninstall chamber-agent -n chamber-system
Uninstalling disconnects your cluster from Chamber. Running workloads will continue to completion but won’t be tracked.

​
Next Steps

Troubleshooting

Common issues and solutions

Upgrading

Upgrade to the latest version