Services

The docker-compose.yml runs seven services:

Production Mode

cd ~/.tandemu  # or wherever you cloned the repo
docker compose up --build -d

This builds the backend and frontend into optimized Docker images and runs everything.

Development Mode

For hot-reload during development:

docker compose -f docker-compose.yml -f docker-compose.dev.yml up

This:

• Starts infrastructure services (Postgres, ClickHouse, Redis, OTel Collector) normally
• Runs the backend with tsc --watch + node --watch — restarts on TypeScript changes
• Runs the frontend with next dev — instant hot module replacement
• Mounts source code as volumes so edits are picked up immediately

Persistent Data

Three named volumes store persistent data:

To reset all data:

docker compose down -v

This removes all volumes. Next up starts fresh.

Updating

cd ~/.tandemu
git pull
docker compose up --build -d

Database migrations are applied automatically by the install script, or manually:

for f in packages/database/src/migrations/*.sql; do
  docker exec -i tandemu-postgres-1 psql -U tandemu -d tandemu < "$f"
done

Health Checks

Postgres, ClickHouse, and Redis have built-in health checks. The backend and frontend wait for Postgres and Redis to be healthy before starting.

Check status:

docker compose ps

All services should show Up or Up (healthy).