---

13 Troubleshooting ¶

Symptom-to-cause lookups for problems that come up in practice. Each entry names the failure mode, where to look, and what to fix.

• Server won’t start
• MCP returns 401
• MCP returns 500 or EMBEDDING_ERROR
• No matches from recall
• Tomcat won’t bind 443
• Deploy is slow or first request 404s
• Migration failures
• Re-embed walker problems
• Backup problems
• CLI: build failures
• CLI: server unreachable