name: Cold-Start Bug #1 — OZM Fresh Install Failure
description: Three simultaneous prerequisites caused port 8000+3000 to start but fail to connect after token/UID setup
type: project

Fresh install at OZM failed with services starting (8000, 3000) but not connecting. Three root causes:

1. docker-compose.env missing — not in git, must be created manually before docker compose up
2. Ollama was shut down — user assumed it was inside Docker; it runs on the host and must be running before paperless-ai starts
3. network_mode: bridge risk — if set on paperless-ai, breaks host.docker.internal access to Ollama

Why: All three are silent failures — services appear healthy but the connection chain breaks invisibly.

How to apply: When troubleshooting "services start but can't connect" issues, check these three in order first. CLAUDE.md should surface these as a pre-flight checklist.