docker-compose.override.yml.example

# ─────────────────────────────────────────────────────────────────────────────
# Development overrides — copy to docker-compose.override.yml (gitignored)
# ─────────────────────────────────────────────────────────────────────────────
# docker-compose.override.yml is automatically merged by Docker Compose.
# Use it to expose internal ports, bind-mount local source, and mount
# a persistent HuggingFace model cache without committing secrets.
# ─────────────────────────────────────────────────────────────────────────────

services:
  postgres:
    # Expose Postgres on the host for direct psql / DBeaver access
    ports:
      - "5432:5432"

  watcher:
    volumes:
      # Bind-mount the local docs/ folder so edits are picked up immediately
      - ./docs:/docs
      # Bind-mount source for live code changes without rebuilding
      - ./src:/app/src
      # Persist downloaded model weights across container restarts
      # - /path/to/hf_cache:/home/appuser/.cache/huggingface

  mcp:
    volumes:
      - ./src:/app/src
      # - /path/to/hf_cache:/home/appuser/.cache/huggingface

  # ── Apache AGE Viewer ──────────────────────────────────────────────────────
  # Graph visualisation UI — built from source on first run (takes ~2 min).
  # Access at http://localhost:3001 after `docker compose up age-viewer`.
  #
  # Connection details to enter in the browser UI:
  #   Host:     postgres
  #   Port:     5432
  #   Database: graphrag
  #   User:     graphrag
  #   Password: (your POSTGRES_PASSWORD from .env)
  age-viewer:
    # Builds from ./docker/age-viewer/Dockerfile (Node 18, clones age-viewer from GitHub).
    # First build takes ~2 min.
    #
    # Connection details to enter in the browser UI:
    #   Host:     postgres   Port: 5432   DB: graphrag   User: graphrag
    build:
      context: ./docker/age-viewer
    restart: unless-stopped
    ports:
      - "3001:3000"
    networks:
      - internal