docker-compose.yml

# NOTE: for development use only, do not run this compose in production!
# ports are not exposed, instead dynamic orb domains are used
services:
  # port 5432
  postgres:
    # NOTE lock this value to the specific version you use in production
    # https://hub.docker.com/_/postgres/
    image: postgres:18
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    ports:
      - ${CI:+5432}:5432
    volumes:
      - app_postgres_data:/var/lib/postgresql/
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      # Use a 24-hour interval trick to disable ongoing background healthchecks after the container reaches a healthy state.
      # This reduces local CPU overhead from pinging the container repeatedly during development.
      interval: 24h
      # Rapid checks every second during initial boot
      start_interval: 1s
      start_period: 10s
      timeout: 5s
      retries: 3

  # port 6379
  redis:
    # NOTE you'll probably need to drop this value for your production environment which will lag edge releases
    image: redis:8
    restart: unless-stopped
    ports:
      - ${CI:+6379}:6379
    healthcheck:
      test: ["CMD-SHELL", "redis-cli ping"]
      # Use a 24-hour interval trick to disable ongoing background healthchecks after the container reaches a healthy state.
      # This reduces local CPU overhead from pinging the container repeatedly during development.
      interval: 24h
      # Rapid checks every second during initial boot
      start_interval: 1s
      start_period: 5s
      timeout: 3s
      retries: 3

  # SMTP sinkhole for easily viewing email in development
  # web ui: 8025
  # smtp: 1025
  mailpit:
    image: axllent/mailpit
    restart: unless-stopped
    ports:
      - ${CI:+1025}:1025
      - ${CI:+8025}:8025
    volumes:
      - mailpit_data:/data
    environment:
      MP_MAX_MESSAGES: 5000
      MP_DATABASE: /data/mailpit.db
      MP_SMTP_AUTH_ACCEPT_ANY: 1
      MP_SMTP_AUTH_ALLOW_INSECURE: 1

  # port 8080
  # IP geolocation JSON API (MaxMind GeoLite2)
  # https://github.com/observabilitystack/geoip-api
  geoip:
    image: ghcr.io/observabilitystack/geoip-api:latest
    restart: unless-stopped
    ports:
      - ${CI:+8080}:8080
    healthcheck:
      # Image ships with curl and /actuator/health
      test: ["CMD-SHELL", "curl -f http://localhost:8080/actuator/health"]
      # Use a 24-hour interval trick to disable ongoing background healthchecks after the container reaches a healthy state.
      # This reduces local CPU overhead from pinging the container repeatedly during development.
      interval: 24h
      # Rapid checks every second during initial boot
      start_interval: 1s
      start_period: 15s
      timeout: 5s
      retries: 5

volumes:
  mailpit_data:
  # NOTE redis data is not persisted, assumed to be ephemeral
  app_postgres_data: