Port fix
Fix Odysseus localhost:7000 not working
If Odysseus starts but the browser cannot open http://localhost:7000, debug the service, port binding, and network layer in that order.
1. Confirm the service is running
From the Odysseus repository directory, check the compose process first. A browser error is often just a container that exited during startup.
docker compose ps
docker compose logs odysseus2. Check whether port 7000 is bound
On Linux or WSL2, use ss. On Windows PowerShell, use netstat.
ss -ltnp | grep 7000
netstat -ano | findstr :7000If another app owns the port, stop that app or change the host port in your compose configuration.
3. Use the correct address for your environment
- Same machine: try
http://localhost:7000. - Remote server: use the server IP only after firewall rules allow the port.
- WSL2: test from inside WSL and from Windows because localhost forwarding can differ.
- Reverse proxy: test the direct local port before debugging Nginx, Caddy, or Cloudflare Tunnel.
4. Read the startup logs
Look for database migration errors, missing environment variables, failed model provider checks, or authentication setup output. Do not delete volumes until you know whether the app actually initialized.
Quick fixes
- Restart the stack:
docker compose restart. - Rebuild only after reading the error:
docker compose up --build. - Check firewall rules if the UI works locally but not from another device.
- Check admin password logs if the UI loads but login fails.