Troubleshooting
The failures a first deployment runs into, what each one looks like, which log shows it, and the fix, from a source stuck at pending to a widget that refuses every origin.
Most first-run problems are one of the cases below. Each names the symptom,
where to look, and the fix. docker compose logs -f worker and
docker compose logs -f web are the two logs that matter; ingestion is in the
first, requests and answers in the second.
Starting
Ingestion
Answering
Behind a proxy
Commands
The commands an operator runs from a checkout, from migrations and seeding through the eval harness to re-indexing a project and pruning a Weaviate collection.
Overview
What Deskbell answers from, the two kinds of source, the states a source moves through, and what happens to a page between the crawl and the first citation.