Docker Compose

Docker Compose is the simplest way to deploy JITSudo for production or evaluation.

Quick Start

git clone https://github.com/jitsudo/jitsudo.git
cd jitsudo
make compose-up

Services

The compose file starts five services:

Service	Image	Description
postgres	postgres:17-alpine	PostgreSQL database with persistent volume
dex	ghcr.io/dexidp/dex:v2.41.1	Local OIDC provider (development only)
migrate	Built from source	Runs goose migrations, exits after completion
server	Built from source	HTTP API server on port 8080
worker	Built from source	Background job processor

Dependencies are managed automatically: migrate waits for postgres health check, server and worker wait for migrate to complete.

Volumes

• postgres-data — persists database across restarts
• go-modules / go-build-cache — caches Go dependencies for faster rebuilds

Configuration

Environment variables are set in the compose file. For production, override them:

DATABASE_URL=postgres://jitsudo:jitsudo@postgres:5432/jitsudo?sslmode=disable
OIDC_ISSUER_URL=http://dex:5556/dex
OIDC_CLIENT_ID=jitsudo-local
OIDC_CLIENT_SECRET=local-secret
JWT_SECRET=change-me-in-production
LOG_LEVEL=info

Caution

The default compose configuration uses Dex as a local OIDC provider. For production, replace OIDC_ISSUER_URL with your organization’s OIDC provider.

Frontend

The frontend runs separately:

make dev-web    # Development server with hot reload
make build-web  # Production build

Stop Services

make compose-down  # Stops containers and removes volumes