Lore
Documentation navigation
Docs/Troubleshooting/Setup issues

Setup issues

Check server address, setup status, health, migrations, and auth problems.

Common setup issues usually fall into one boundary.

Common boundaries

SymptomCheck
server does not startDocker logs, DATABASE_URL, PostgreSQL health, Redis URL
migration failsdatabase user permissions, vector extension availability, pg_jieba preload if used
/api/health failsWeb container logs and network port mapping
browser/API auth failsAPI_TOKEN, bearer header, browser session, reverse proxy headers
setup cannot save model configprovider base URL, API key, model name, timeout

For Docker installs, inspect logs from the directory containing docker-compose.yml:

*.bash
Shell
docker compose ps
docker compose logs web
docker compose logs postgres
Recall issuesFix missing memories, noisy results, slow recall, and confusing query output.Agent issuesFix boot context, recall hooks, MCP tools, and stale agent memory.Common questionsShort answers for everyday Lore usage decisions.Memory writing tipsUse a practical checklist and example for durable memory shape.