FAQ

Frequently asked questions about GitOpsHQ — setup, deployments, governance, troubleshooting, and more.

Can't find your answer?

Check the Runbooks for step-by-step incident resolution, or the How-To Guides for task-oriented walkthroughs.

Getting Started

For detailed step-by-step resolution, see the full Runbooks.

Symptom	Likely Cause	First Action
Agent shows Disconnected	Pod crash, network block, or expired token	`kubectl get pods -n gitopshq-system`
Release status is Failed	Template error or cluster rejection	Check delivery generator output
Promotion stage is Blocked	Freeze, missing approval, or OPA violation	Check promotion detail page
Webhooks not delivering	Endpoint down or HMAC mismatch	Check webhook delivery logs
OPA blocking release	Non-compliant values	Review violation details, fix values
Drift detected in production	Manual kubectl edit or bypassed pipeline	Identify drifted resources in dashboard
Chart pull failing	Expired registry credentials	Test connection in Settings > Registry
Action button is hidden/disabled	Missing permission grant	Check effective permissions for your role