Install Odysseus with Docker
The official recommended method — works on Windows, macOS, and Linux.
Quick answer
Requirements: Docker Desktop (Windows/Mac) or Docker Engine (Linux).
Expected result: http://localhost:7000 shows the Odysseus login. First-run admin password appears in container logs.
Install commands
terminal
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env # optional
docker compose up -d --build
# Open http://localhost:7000
docker compose logs odysseus # find admin passwordConnect Ollama from Docker
When Odysseus runs inside Docker, localhost refers to the container — not your host machine.
terminal
# Odysseus in Docker + Ollama on host:
# 1. Install Ollama on your machine (not in container)
# 2. Pull a model: ollama pull llama3.2
# 3. In Odysseus Settings, add endpoint:
# Windows/Mac: http://host.docker.internal:11434/v1
# Linux: http://172.17.0.1:11434/v1 (or host network mode)NVIDIA GPU (optional)
For Cookbook model serving with GPU acceleration inside Docker.
terminal
# Add to docker-compose.yml under odysseus service for NVIDIA GPU:
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: all
capabilities: [gpu]FAQ