docker-compose.yml

# Image built from digest-pinned Dockerfile + frozen uv.lock (see CONTRIBUTING.md).
services:
  paperscout:
    build:
      context: .
      target: production
    ports:
      - "127.0.0.1:9100:3000"
      - "127.0.0.1:9101:8080"
    env_file: .env
    environment:
      HEALTH_BIND_HOST: "0.0.0.0"
      # Passed into the container so the startup budget check can compare it
      # against the configured shutdown timeouts.  Must match stop_grace_period.
      STOP_GRACE_PERIOD_SECONDS: "${STOP_GRACE_PERIOD_SECONDS:-45}"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "5"
    # Must exceed the combined shutdown budget:
    # SHUTDOWN_MQ_DRAIN_TIMEOUT_SECONDS (30 s default)
    # + SHUTDOWN_THREAD_JOIN_TIMEOUT_SECONDS × 2 (5 s × 2 = 10 s default)
    # = 40 s.  Keep at least 5 s of headroom above that sum.
    # Override STOP_GRACE_PERIOD_SECONDS in the environment or .env file to
    # change both this period and the in-process budget check simultaneously.
    stop_grace_period: "${STOP_GRACE_PERIOD_SECONDS:-45}s"
    restart: unless-stopped