ArgoCD troubleshooting guides
Resolve ArgoCD sync and health problems, from OutOfSync drift to failed applies, traced back to the manifest or commit behind them.
New here? Start with the field guide: Diagnosing ArgoCD: sync & health failures →
See how Intellira automates this: ArgoCD root cause analysis →
Degraded
A Degraded ArgoCD app synced fine but a resource is unhealthy. Health — not sync — names the failing resource, and the app inherits the worst child health.
OutOfSync
An ArgoCD app shows OutOfSync when live cluster state deviates from the target state in Git. How to read the diff, find the real source of drift, and fix it.
ProgressingStuck
An ArgoCD app stuck Progressing is moving toward Healthy but never arrives. Sync status and health status are orthogonal — fix the workload, not the sync.
SyncFailed
When an ArgoCD sync fails, either the manifests never rendered or the apply errored. Read the operation message to find which, then the failing resource.