chorusaidlc/chorus-app repository overview

⁠Chorus Docker Image

chorusaidlc/chorus-app — The official Docker image for Chorus⁠, an AI Agent & Human collaboration platform implementing the AI-DLC (AI-Driven Development Lifecycle) workflow.

⁠Quick Start

docker pull chorusaidlc/chorus-app:latest

⁠Docker Compose — Standalone (Recommended)

No external database needed. The image bundles PGlite⁠ (embedded PostgreSQL) and starts everything automatically.

Create a docker-compose.local.yml:

# Standalone Chorus — embedded PGlite, no external PostgreSQL or Redis
services:
  app:
    image: chorusaidlc/chorus-app:latest
    ports:
      - "8637:8637"
    environment:
      # No DATABASE_URL — entrypoint auto-starts embedded PGlite
      - REDIS_URL=
      - NEXTAUTH_SECRET=${NEXTAUTH_SECRET:-chorus-local-secret}
      - COOKIE_SECURE=false
      - DEFAULT_USER=${DEFAULT_USER:[email protected]}
      - DEFAULT_PASSWORD=${DEFAULT_PASSWORD:-changeme}
    volumes:
      - chorus-local-data:/app/data

volumes:
  chorus-local-data:

Then run:

docker compose -f docker-compose.local.yml up -d

Open http://localhost:8637⁠ and log in with [email protected] / changeme (or override via DEFAULT_USER / DEFAULT_PASSWORD env vars).

The embedded mode:

• Starts PGlite on an internal port (5433), not exposed externally
• Stores data in a Docker volume — persists across container restarts
• Disables Redis (falls back to in-memory EventBus — single-instance only)
• Runs Prisma migrations automatically on startup

⁠Production Deployment (PostgreSQL + Redis)

For production with multiple replicas, use Docker Compose with external PostgreSQL and Redis.

Create a docker-compose.yml:

services:
  app:
    image: chorusaidlc/chorus-app:latest
    ports:
      - "8637:8637"
    environment:
      - DATABASE_URL=postgresql://chorus:chorus@db:5432/chorus
      - REDIS_URL=redis://default:chorus-redis@redis:6379
      - NEXTAUTH_SECRET=change-me-to-a-random-secret
      - [email protected]
      - DEFAULT_PASSWORD=your-password
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy

  redis:
    image: redis:7-alpine
    command: redis-server --requirepass chorus-redis
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "-a", "chorus-redis", "ping"]
      interval: 5s
      timeout: 3s
      retries: 5

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

volumes:
  chorus-data:
  redis-data:

Then run:

docker compose up -d

Open http://localhost:8637⁠ and log in with the credentials you set in DEFAULT_USER / DEFAULT_PASSWORD.

⁠Docker Run (with existing PostgreSQL)

If you already have PostgreSQL and Redis running:

docker run -d \
  -p 8637:8637 \
  -e DATABASE_URL=postgresql://user:pass@your-db-host:5432/chorus \
  -e REDIS_URL=redis://default:password@your-redis-host:6379 \
  -e NEXTAUTH_SECRET=change-me-to-a-random-secret \
  -e COOKIE_SECURE=false \
  -e [email protected] \
  -e DEFAULT_PASSWORD=your-password \
  chorusaidlc/chorus-app:latest

⁠Environment Variables

⁠Required

⁠Database (Alternative to DATABASE_URL)

If DATABASE_URL is not set, the entrypoint builds it from these individual variables:

⁠Redis

⁠Authentication

⁠Logging

Production Docker images always output JSON to stdout (ready for CloudWatch / ELK). Colorized pretty output is only available in local development (pnpm dev).

⁠Super Admin

⁠Image Details

• Base image: node:22-alpine
• Internal port: 8637
• Entrypoint: Runs Prisma migrations automatically on startup (retries for up to 5 minutes while waiting for the database)
• Build: Next.js standalone output for minimal image size
• Architectures: linux/amd64, linux/arm64

⁠Startup Behavior

1. If DATABASE_URL is not set and no DB_* variables are provided, the entrypoint starts an embedded PGlite instance on an internal port
2. The entrypoint runs prisma migrate deploy to apply any pending database migrations
3. If the database is not ready, it retries every 10 seconds (up to 30 attempts)
4. Once migrations succeed, the Next.js server starts on port 8637

⁠Source Code

https://github.com/Chorus-AIDLC/Chorus⁠