Common questions and fixes. If you're stuck, run dl doctor first; it checks your providers, stores, and config and usually points straight at the problem:
docker compose exec datalumo dl doctor
The install finished but the site won't load over HTTPS.
Almost always DNS or ports. Check your domain's A record points at the server, and that ports 80 and 443 are open. Caddy needs both to get a certificate. Then:
docker compose logs caddy
The server already runs nginx, Apache, or a panel on 80/443.
Install in behind-proxy mode so Datalumo doesn't fight for those ports. See Reverse proxies and multiple instances.
Where is my admin key?
docker compose exec datalumo cat /app/data/admin-key
Search returns nothing.
Check the index actually has content (dl index list), and that you're querying the right app and index. Newly added content is searchable as soon as it finishes embedding.
Answers are wrong or thin.
Usually retrieval, not the model. Add more relevant content, and in the app's settings raise k (how many passages it retrieves) or lower minScore. Turn on hybrid search for keyword-heavy content.
A provider error appears in chat.
Your provider key is missing, wrong, or out of quota. Check it:
docker compose exec datalumo dl env set OPENAI_API_KEY=sk-…
docker compose restart datalumo
Does my data leave my server?
Your documents stay on your server. Search queries and the matching passages go to the AI provider you chose, on your key. Full detail in Your data and privacy.
Which AI provider should I use?
Any supported one works. Start with what you already have an account for. You can change providers, but switching the embedding model means re-indexing.
What does it cost to run?
A small VPS plus what your AI provider charges for usage. You pay the provider directly; there's no markup. See System requirements.
Can I run several sites or customers on one server?
Yes. See Reverse proxies and multiple instances. Each instance needs its own license.
How do I back up?
See Updates and backups. On SQLite it's a single file.
Grab the logs and contact support:
docker compose logs --tail=200 datalumo