Docker Setup

The root docker-compose.yml runs the application and PostgreSQL with pgvector. PostgreSQL also backs cache, queue, and pub/sub features; the current stack has no Valkey service.

Start the stack

Create the environment file described by the repository’s docs/DOCKER.md, then run:

docker compose --env-file .env.docker up --build -d
docker compose --env-file .env.docker ps
docker compose --env-file .env.docker logs -f octipus

The application health endpoint is /api/health. Compose exposes the API on host port 3015 and the web UI on 3017 by default; their internal ports remain 3005 and 3007. Take service names, environment variables, ports, and volume names from the compose file at the commit you deploy.

Update

git pull --ff-only
docker compose --env-file .env.docker build
docker compose --env-file .env.docker up -d

Back up PostgreSQL before upgrades. docker compose down -v deletes stored data.