Docker Deployment

See the Getting Started: Docker guide for basic Docker setup.

Production Docker Compose

A production-ready docker-compose.yml:

version: "3.8"

services:
  deltallm:
    build: .
    ports:
      - "4002:4000"
    environment:
      - DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/deltallm
      - REDIS_URL=redis://redis:6379/0
      - DELTALLM_CONFIG_PATH=/app/config/config.yaml
      - DELTALLM_MASTER_KEY=${DELTALLM_MASTER_KEY}
      - DELTALLM_SALT_KEY=${DELTALLM_SALT_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - PLATFORM_BOOTSTRAP_ADMIN_EMAIL=${ADMIN_EMAIL}
      - PLATFORM_BOOTSTRAP_ADMIN_PASSWORD=${ADMIN_PASSWORD}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    volumes:
      - ./config.yaml:/app/config/config.yaml:ro
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:4000/health/liveliness"]
      interval: 30s
      timeout: 10s
      retries: 3

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: deltallm
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:7-alpine
    volumes:
      - redisdata:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  pgdata:
  redisdata:

Environment File

Create a .env file alongside docker-compose.yml:

POSTGRES_PASSWORD=strong-random-password
DELTALLM_MASTER_KEY=replace-me
DELTALLM_SALT_KEY=replace-me
OPENAI_API_KEY=sk-...
ADMIN_EMAIL=admin@company.com
ADMIN_PASSWORD=initial-admin-password

Generate working values for the master key and salt key with:

python3 -c 'import secrets; print("DELTALLM_MASTER_KEY=sk-" + secrets.token_hex(20) + "A1")'
python3 -c 'import secrets; print("DELTALLM_SALT_KEY=" + secrets.token_hex(32))'

The generated master key always satisfies DeltaLLM's validator: it is longer than 32 characters and includes both letters and numbers.

Starting

docker compose up -d

With this host mapping, the Docker deployment is reachable at http://localhost:4002.

Upgrading

docker compose pull
docker compose up -d --build

The application container runs the shared database bootstrap script on startup before launching the API. The bootstrap runs strict prisma migrate deploy with database-connectivity retries; it does not run prisma db push.