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

# Upgrading

> Upgrade the Chamber agent to newer versions

This guide covers upgrading the Chamber agent to newer versions.

## Check Current Version

```bash theme={null}
helm list -n chamber-system
```

## Check Available Versions

Visit the [releases page](https://github.com/ChamberOrg/chamber-agent/releases) for the latest version and changelog.

## Upgrade to Latest

```bash theme={null}
helm upgrade chamber-agent oci://public.ecr.aws/chamber/chamber-agent-chart \
  -n chamber-system \
  --reuse-values
```

<Info>
  `--reuse-values` preserves your existing configuration (token, cluster ID, etc.).
</Info>

## Upgrade to Specific Version

```bash theme={null}
helm upgrade chamber-agent oci://public.ecr.aws/chamber/chamber-agent-chart \
  -n chamber-system \
  --version 0.8.96 \
  --reuse-values
```

<Tip>
  Pinning to a specific version ensures reproducible deployments across environments.
</Tip>

## Verify Upgrade

```bash theme={null}
# Check rollout status
kubectl rollout status deployment/chamber-agent -n chamber-system

# Check the new version
helm list -n chamber-system

# Check logs for errors
kubectl logs -n chamber-system -l app.kubernetes.io/name=chamber-agent --tail=50
```

Look for successful connection messages:

```
INFO  WebSocket connected successfully
INFO  Metadata collected: X nodes, Y GPUs
```

## Rollback

If issues occur after upgrade:

```bash theme={null}
# View upgrade history
helm history chamber-agent -n chamber-system

# Rollback to previous version
helm rollback chamber-agent -n chamber-system

# Or rollback to specific revision
helm rollback chamber-agent 2 -n chamber-system
```

## Related Pages

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/agent/installation">
    Fresh installation guide
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/agent/troubleshooting">
    Fix post-upgrade issues
  </Card>
</CardGroup>