Connect a cluster

Connecting takes one Helm command. When you connect a cluster in the Runtimez UI, we generate your exact command and a connection token — the snippet below shows the shape of it.

Install

# 1. Add the Runtimez chart repository
helm repo add runtimez https://charts.runtimez.io
helm repo update

# 2. Install the read-only agent
helm install runtimez-agent runtimez/agent \
  --namespace runtimez --create-namespace \
  --set token=<YOUR-CONNECT-TOKEN>

Note

The token above is a placeholder. Your real connect token is generated per cluster in the Runtimez UI — do not commit it to a repository or paste it into a shared channel.

Verify the agent is running

kubectl get pods -n runtimez
kubectl logs -n runtimez deploy/runtimez-agent --tail=50

The agent installs into its own namespace and binds to a ClusterRole scoped to read-only verbs. See RBAC & security model for the exact manifest, and review the chart before you install if you want to.

What happens next

The agent performs an initial inventory sync, then keeps it current. Your first production-risk report typically lands in under an hour.

Next

• The cluster view — the twelve tabs and what each one answers.
• rtz CLI — query what the agent synced from your terminal.
• Uninstall — one command, ends read access immediately.