Operations
Troubleshooting
Common issues across all deployment modes
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Common issues across all deployment modes
| 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 |
queued foreverunauthorizedfracta init fails