Local Troubleshooting

"Ollama unreachable"

1. Verify Ollama is running: curl http://localhost:11434/api/tags
2. Check OLLAMA_URL env var if using a remote Ollama
3. Ensure the model is pulled: ollama pull llama3.2

"No store adapter configured"

Your config/config.yaml is missing the adapters.store section. Run npm run setup or copy from config/defaults.yaml.

"Migration failed"

1. Check SQLite file permissions: ls -la data/docket.db
2. Ensure the directory exists: mkdir -p data
3. Try deleting the DB and letting it recreate: rm data/docket.db

"Port 3000 already in use"

lsof -i :3000
# Or change the port:
DOCKET_PORT=8080 npm start

Slow queries

1. Enable WAL mode in SQLite config (default)
2. Check if Ollama is using CPU instead of GPU
3. Reduce maxConcurrent in queue config

Doctor fails

Run each check individually to isolate:

node src/scripts/doctor.js