Self-host with Docker

Docker mode runs two services:

• App (control plane): UI + scheduler/state machine + SQLite + SSE
• Runner (execution plane): isolated execution (starts sandbox containers and streams logs back)

Quick start

1. Download docker-compose.release.yml and .env.production

    curl -fsSL -o docker-compose.release.yml https://raw.githubusercontent.com/obiscr/maia/main/docker-compose.release.yml
    curl -fsSL -o .env.production https://raw.githubusercontent.com/obiscr/maia/main/env.example

2. Edit .env.production and set RUNNER_TOKEN.

   .env.production

   RUNNER_TOKEN=your-token

3. Start

   docker compose -f docker-compose.release.yml --env-file .env.production up -d

Set up

Initial setup Open http://localhost:3690 to run the initial setup wizard.

Get updates

When you use docker-compose.release.yml (pre-built image) to deploy, updates usually involve “pulling new image → rebuilding and restarting”:

docker compose -f docker-compose.release.yml --env-file .env.production pull
docker compose -f docker-compose.release.yml --env-file .env.production up -d --remove-orphans