Installing
The install command exits immediately with an error about CG_CLUSTER_NAME
The install command exits immediately with an error about CG_CLUSTER_NAME
Both
CG_API_KEY and CG_CLUSTER_NAME are required — the installer refuses to run without them, and the Helm chart refuses to render without agent.clusterName. The correct commands are on Install ChangeGuard.How long until I see my first score?
How long until I see my first score?
Your cluster connects within about a minute of install (up to ~2 minutes on a first-ever install while images pull), and the first CSC Score follows within ~10 seconds of connecting. If it’s been longer, the fix table covers the three causes — it’s almost always egress or the API key.
We use an HTTP(S) proxy — can the collector go through it?
We use an HTTP(S) proxy — can the collector go through it?
Not today. The cluster needs direct outbound HTTPS to
api.changeguard.ai:443. This is tracked on Known Limitations & Roadmap.Can we install air-gapped or from our own registry?
Can we install air-gapped or from our own registry?
Yes — mirror the images and repoint every one of them with
--set global.imageRegistry=<your-registry>. The registry list is on Before you install.Does anything run privileged?
Does anything run privileged?
One component: the Falco DaemonSet (runtime syscall detection), on by default with security scanning. Everything else runs unprivileged and read-only. What it mounts, why, and how to disable it: Permissions & RBAC.
How do I uninstall completely?
How do I uninstall completely?
Helm uninstall plus one manual step (deleting the CRD) — exact commands on Install ChangeGuard. Removing already-sent data is per-cluster in-app; full-tenant erasure goes through support.
Using ChangeGuard
What do SHIP / HOLD / BLOCK mean?
What do SHIP / HOLD / BLOCK mean?
The one verdict vocabulary, everywhere: SHIP = safe to ship, HOLD = caution — review before shipping, BLOCK = expected to fail (and, at Approve/Auto autonomy, gated until a human approves). Verdicts are advisory unless you wire the CI gate yourself.
I don't see the Engineering Advisor / Opinion / Experience
I don't see the Engineering Advisor / Opinion / Experience
Expected — those are Early Access, off by default, and not self-serve. What’s GA for every tenant and how to join EA: Engineering Advisor and Product concepts.
How do I change the collector's CPU/memory?
How do I change the collector's CPU/memory?
Defaults are requests 25m/64Mi, limits 500m/512Mi (chart ≥ 5.3.6). Override any subset:
--set agent.collector.resources.limits.memory=1Gi — see Operations.How do I rotate an API key safely?
How do I rotate an API key safely?
Create the new key in-app, update the
changeguard-credentials Secret, restart the collector, then revoke the old key — steps on Operations. There’s no self-serve rotation API yet; after a suspected exposure, also confirm invalidation with support.Is ChangeGuard going to block my deploys?
Is ChangeGuard going to block my deploys?
Not unless you tell it to. Verdicts are advisory; the default autonomy level is Advise. Blocking only happens where you wire the CI gate or enable Approve/Auto autonomy with its RBAC — see How ChangeGuard Makes Decisions.
Troubleshooting
The two canonical fix tables:- Install and first connection — Connect your first cluster: repeated
401s, egress timeouts, cluster never appearing in Fleet, operatorCrashLoopBackOff. - Day-2 operations — Operations handbook: collector crash loops, stale clusters, missing features, version skew.
kubectl logs -n changeguard-agent deploy/changeguard-collector --tail=50); they contain no secrets.