Docker install

Odysseus Docker install checklist

Docker is usually the most repeatable way to run Odysseus, but it still needs careful volume, port, model, and GPU planning.

Checklist

Confirm Docker Engine or Docker Desktop is healthy before launching Odysseus.
Use named volumes or explicit bind mounts so app data survives upgrades.
Record the exposed port and avoid conflicts with other local AI tools.
Connect Ollama or your model server from the correct network namespace.
Keep secrets in environment variables or local config files outside public repos.

Ports and networking

If the web UI does not load, check whether the container is running, whether the host port is bound, and whether a firewall is blocking access. On Windows and macOS, remember that Docker runs through a VM layer, so localhost behavior can differ from native Linux.

Reverse proxy safety

Odysseus is powerful because agents and MCP tools can touch real resources. Treat external exposure as a security project, not a convenience switch. Use TLS, authentication, rate limits, and private access rules.