docker-compose.dev.yml

# Overrides only. Anything this file does not mention is inherited from
# docker-compose.yml as it stands there.
#
# The database is deliberately absent. Compose *appends* `ports` across files
# instead of replacing the list, so republishing it here produced two entries
# for host port 5434 - the base file's `127.0.0.1:` one and a second with no
# bind address, meaning every interface. The stack could not start (the port is
# claimed twice) and the entry that would have survived a careless fix was the
# one exposing Postgres to the network, against the loopback-only contract in
# docs/DEV_RULES.md. `DB_HOST_PORT` already reaches the base file; it does not
# need saying twice.
services:
  app:
    environment:
      - DEV_MODE=true
      # AUTO_START_SCHEDULER is deliberately NOT here. It used to be forced to
      # `true` - not `${AUTO_START_SCHEDULER:-true}` but a flat value, and
      # Compose lets the later file's key win, so `docker compose -f
      # docker-compose.dev.yml up` (the workflow CLAUDE.md documents under Run)
      # started ingestion on a dev checkout whatever that machine's .env said,
      # against the same mailbox as the deployment (#376). Inherit the base
      # file's guarded default instead; a machine that really should ingest
      # sets the variable in its own .env.
    command: >
      sh -c "python -m migrations.runner &&
      exec gunicorn --bind 0.0.0.0:5001 --workers 1 --threads 4 --reload main:app"
    volumes:
      - .:/app