Troubleshooting#

Organized by symptom, not by subsystem. Find your error message, follow the diagnosis. For bugs that live in the code itself, see Known Issues.

Setup & boot#

Chat & LLM#

Tools & workflows#

??? failure "A workflow run is stuck in status: \"running\""

The process died mid-pipeline (crash/restart) after the run was committed. There is no resumption — treat it as failed and rerun. [Workflows](../workflows/index.md).

Documents & RAG#

Frontend#

Docs site#

Build and deploy issues for this documentation: Docs Site → Troubleshooting deploys.

Still stuck?#

Reproduce with curl against :8001 directly (eliminates the frontend), watch the uvicorn console for the traceback, and query the telemetry tables — failures always leave records (Observability). Then check Known Issues and the FAQ.