Prerequisites

Required Software

Docker Engine

Docker Engine 24+ is required. Install via the official convenience script or your distribution’s package manager.

# Official install script (Ubuntu/Debian)
curl -fsSL https://get.docker.com | sh

# Add your user to the docker group
sudo usermod -aG docker $USER

# Verify
docker --version

Docker Compose

Docker Compose v2 ships with modern Docker Engine installs. Verify it’s available:

docker compose version
# Docker Compose version v2.x.x

If you have an older Docker installation that only provides docker-compose (v1), upgrade Docker Engine.

That’s it — no other software is required. You don’t need to clone the repository, install Go, Node.js, or any other build tools.

Ports

The default port mappings when using the built-in Caddy reverse proxy:

Service	Default Port	Purpose
HTTP	80	Web UI and API (redirects to HTTPS)
HTTPS	443	Web UI and API

If you’re running without the Caddy proxy (using your own reverse proxy), the internal service ports are:

Service	Container Port	Purpose
Go API	8080	Backend API
Next.js	3000	Web UI
PostgreSQL	5432	Database
Ollama	11434	LLM inference
Kokoro	8880	Text-to-speech
Whisper	8178	Speech-to-text

If any ports conflict with existing services, see the Ports & Networking page to customize them.