Docker Compose

# Self-host AgentSDR with Docker Compose.
#
#   cp .env.example .env      # set the REQUIRED values (see docs/self-hosting.md)
#   docker compose up -d      # builds the image, creates the schema, starts the app
#
# Then open http://localhost:3000 (or your BETTER_AUTH_URL), sign up and
# create your organization. Full guide: docs/self-hosting.md.

name: agentsdr

services:
  db:
    image: postgres:18-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: agentsdr
      POSTGRES_USER: agentsdr
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}
    volumes:
      - db-data:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U agentsdr -d agentsdr"]
      interval: 5s
      timeout: 5s
      retries: 20

  # One-shot: creates the schema in an empty database; a no-op afterwards.
  setup:
    build: .
    image: agentsdr:local
    command: ["bun", "scripts/db/setup.ts", "--if-empty"]
    environment: &db-env
      DATABASE_URL: postgres://agentsdr:${POSTGRES_PASSWORD}@db:5432/agentsdr
      DATABASE_SSL: disable
    depends_on:
      db:
        condition: service_healthy
    restart: "no"

  app:
    image: agentsdr:local
    restart: unless-stopped
    env_file: .env
    environment:
      <<: *db-env
    ports:
      - "${PORT:-3000}:3000"
    depends_on:
      setup:
        condition: service_completed_successfully

  # Calls the scheduled job endpoints (docker/cron/crontab). The send loop
  # itself runs inside the app; these are the daily and periodic jobs.
  cron:
    image: alpine:3.22
    restart: unless-stopped
    environment:
      APP_URL: http://app:3000
      CRON_SECRET: ${CRON_SECRET:?Set CRON_SECRET in .env}
      OUTREACH_TICK_SECRET: ${OUTREACH_TICK_SECRET:?Set OUTREACH_TICK_SECRET in .env}
    volumes:
      - ./docker/cron/crontab:/etc/agentsdr/crontab:ro
      - ./docker/cron/entrypoint.sh:/entrypoint.sh:ro
    entrypoint: ["/bin/sh", "/entrypoint.sh"]
    depends_on:
      - app

volumes:
  db-data:

COMPOSE_FILE=docker-compose.yml:docker-compose.external-db.yml
DATABASE_URL=postgres://user:password@your-host:5432/agentsdr
DATABASE_SSL=            # empty = TLS on, which hosted Postgres expects

docker compose ps              # db: healthy, app and cron: running, setup: exited (0)
docker compose logs setup      # "Database ready: N tables." the first time, "Database already initialised" after
docker compose logs -f app     # the Next.js server log
docker compose logs cron       # "agentsdr cron: schedules loaded"

docker compose stop            # stop, keep data
docker compose up -d           # start again
docker compose down            # remove containers, keep the db-data volume
docker compose down -v         # also DELETE the database volume (all data)

git pull
docker compose up -d --build