By deployment mode
Local process
Docker Compose
Kubernetes
The most complete troubleshooting reference for kubernetes mode lives in the Kubernetes Runbook. The table below summarises the most common issues.| Symptom | Likely cause | Fix |
|---|---|---|
Pod stuck in Pending | PVC not bound, node selector mismatch | Check PVC binding and node labels |
| Agent Job exits immediately | Image pull failure or missing config | kubectl describe job/fracta-agent-<task> |
| Tool calls return 401 | Credential profile not mounted in pod | Check ConfigMap/Secret references |
| Gateway can’t reach FalkorDB | Service DNS or port mismatch | Verify falkordb.fracta.svc:6379 |