docker-compose.dev.yaml

# =============================================================================
# Notetify — development stack
# -----------------------------------------------------------------------------
# Brings up the full local environment: Postgres, Redis, the Laravel API,
# the React client, the Hocuspocus collab hand-off (run separately), plus
# dev-only observability and storage tooling (Mailpit, Seq, RustFS,
# Pulse).
#
# Bring up:   docker compose -f docker-compose.dev.yaml up --build
# Tear down:  docker compose -f docker-compose.dev.yaml down
#
# All resource limits are conservative dev defaults — bump them if a service
# starts OOM-killing on your machine. They're applied via `deploy.resources`
# which Docker Compose v2 honours even outside of swarm.
# =============================================================================

services:

  # ---------------------------------------------------------------------------
  # db — Postgres
  # Primary datastore. Holds users, notes (incl. content JSONB + ydoc_state
  # BYTEA), tags, sessions. Source of truth for everything except live CRDT
  # state in Hocuspocus memory.
  # Reachable on host: localhost:5432
  # ---------------------------------------------------------------------------
  db:
    image: postgres:18.1-alpine
    container_name: notetify-db
    networks:
      - notetify-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "${POSTGRES_USER:-postgres}", "-d", "${POSTGRES_DB:-notetify}"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 10s
    user: postgres
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=${DB_DATABASE:-notetify}
      - POSTGRES_USER=${DB_USERNAME:-postgres}
      - POSTGRES_PASSWORD=${DB_PASSWORD:-postgres}
    expose:
      - 5432
    ports:
      - "5433:5432"
    env_file:
      - .env
    deploy:
      resources:
        limits:
          cpus: "1.5"
          memory: 1g
        reservations:
          cpus: "0.25"
          memory: 256m

  # ---------------------------------------------------------------------------
  # redis — Redis 8
  # Multi-purpose: Laravel cache + sessions + queue + Pulse ingest +
  # Hocuspocus pub/sub for SSE invalidation.
  # Reachable on host: localhost:6379
  # ---------------------------------------------------------------------------
  redis:
    image: redis:8.0.1-alpine
    container_name: notetify-redis-cache
    networks:
      - notetify-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 5s
    volumes:
      - redis-data:/data
    expose:
      - 6379
    ports:
      - "6379:6379"
    env_file:
      - .env
    deploy:
      resources:
        limits:
          cpus: "0.5"
          memory: 512m
        reservations:
          cpus: "0.1"
          memory: 64m

  # ---------------------------------------------------------------------------
  # mailpit — SMTP catcher + web UI
  # Catches every outgoing email from Laravel in dev (verification, password
  # reset, etc.) so nothing actually leaves the machine.
  # Web UI:   http://localhost:8025
  # SMTP in:  mailpit:1025 (used by api MAIL_HOST)
  # ---------------------------------------------------------------------------
  mailpit:
    image: axllent/mailpit:latest
    container_name: notetify-mailpit
    networks:
      - notetify-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:8025/livez"]
      interval: 15s
      timeout: 5s
      retries: 5
      start_period: 5s
    environment:
      MP_MAX_MESSAGES: 5000
      MP_SMTP_AUTH_ACCEPT_ANY: 1
      MP_SMTP_AUTH_ALLOW_INSECURE: 1
    env_file:
      - .env
    ports:
      - "1025:1025"   # SMTP
      - "8025:8025"   # Web UI
    deploy:
      resources:
        limits:
          cpus: "0.25"
          memory: 128m
        reservations:
          cpus: "0.05"
          memory: 32m

  # ---------------------------------------------------------------------------
  # seq — structured log store + search UI
  # Optional. Receives JSON logs from Laravel (configure via Monolog channel
  # pointing at http://seq:5341/api/events/raw). Use for searching across
  # api, pulse logs from one UI.
  # Web UI:   http://localhost:5341
  # Ingest:   http://seq:5341  (from inside the network)
  # ---------------------------------------------------------------------------
  seq:
    image: datalust/seq:latest
    container_name: notetify-seq
    networks:
      - notetify-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost/health"]
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 20s
    environment:
      ACCEPT_EULA: "Y"
      SEQ_FIRSTRUN_NOAUTHENTICATION: "true"
    env_file:
      - .env
    volumes:
      - seq-data:/data
    ports:
      - "5341:80"     # Web UI + ingest
    deploy:
      resources:
        limits:
          cpus: "0.5"
          memory: 512m
        reservations:
          cpus: "0.05"
          memory: 64m

  # ---------------------------------------------------------------------------
  # rustfs — S3-compatible object storage
  # Holds note attachments (images, files dropped into the editor). Laravel's
  # `rustfs` filesystem disk points here. Note bodies stay in Postgres; only
  # binary attachments live here.
  # S3 API:   http://rustfs:9000  (used by api RUSTFS_ENDPOINT)
  # Console:  http://localhost:9001   (login: rustfs / rustfs-secret)
  # ---------------------------------------------------------------------------
  rustfs:
    image: rustfs/rustfs:latest
    container_name: notetify-rustfs
    networks:
      - notetify-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:9000/minio/health/live"]
      interval: 15s
      timeout: 5s
      retries: 10
      start_period: 10s
    environment:
      RUSTFS_ROOT_USER: rustfs
      RUSTFS_ROOT_PASSWORD: rustfs-secret
      RUSTFS_VOLUMES: /data
    env_file:
      - .env
    volumes:
      - rustfs-data:/data
    ports:
      - "9000:9000"   # S3 API
      - "9001:9001"   # Console UI
    deploy:
      resources:
        limits:
          cpus: "1.0"
          memory: 512m
        reservations:
          cpus: "0.1"
          memory: 64m

  # ---------------------------------------------------------------------------
  # api — Laravel HTTP API (PHP-FPM + nginx in one image)
  # Serves /api/*. Owns auth (Sanctum), notes/notebooks/tags CRUD, the collab
  # JWT issuer, and the Hocuspocus persistence webhooks. Uses Postgres,
  # Redis, RustFS, and Mailpit.
  # API:        http://localhost:8000
  # API:        http://localhost:8000/horizon
  # Telescope:  http://localhost:8000/telescope
  # Pulse:      http://localhost:8000/pulse
  # ---------------------------------------------------------------------------
  api:
    build:
      context: ./api
      dockerfile: docker/Dockerfile
      target: development
    container_name: notetify-api
    networks:
      - notetify-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1/up"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      mailpit:
        condition: service_started
      rustfs:
        condition: service_started
    volumes:
      - ./api:/app
      - api_vendor:/app/vendor
      - api_storage:/app/storage
    ports:
      - "8000:80"
    environment:
      - DB_HOST=${DB_HOST:-db}
      - DB_PORT=${DB_PORT:-5432}
      - DB_DATABASE=${DB_DATABASE:-notetify}
      - DB_USERNAME=${DB_USERNAME:-postgres}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
      - APP_ENV=${APP_ENV:-local}
      - APP_DEBUG=${APP_DEBUG:-true}
      - MAIL_MAILER=${MAIL_MAILER:-smtp}
      - MAIL_HOST=${MAIL_HOST:-mailpit}
      - MAIL_PORT=${MAIL_PORT:-1025}
      - MAIL_USERNAME=${MAIL_USERNAME:-null}
      - MAIL_PASSWORD=${MAIL_PASSWORD:-null}
      - MAIL_ENCRYPTION=${MAIL_ENCRYPTION:-null}
      - RUSTFS_ENDPOINT=${RUSTFS_ENDPOINT:-http://rustfs:9000}
      - RUSTFS_KEY=${RUSTFS_KEY:-rustfs}
      - RUSTFS_SECRET=${RUSTFS_SECRET:-rustfs-secret}
      - RUSTFS_BUCKET=${RUSTFS_BUCKET:-notetify}
      - RUSTFS_REGION=${RUSTFS_REGION:-us-east-1}
      - RUSTFS_USE_PATH_STYLE_ENDPOINT=${RUSTFS_USE_PATH_STYLE_ENDPOINT:-true}
      - FILESYSTEM_DISK=${FILESYSTEM_DISK:-rustfs}
      - CLIENT_URL=${CLIENT_URL:-http://localhost:5173/}
    env_file:
      - .env
    deploy:
      resources:
        limits:
          cpus: "2.0"
          memory: 1g
        reservations:
          cpus: "0.25"
          memory: 256m

  # ---------------------------------------------------------------------------
  # pulse — Pulse aggregator
  # Reuses the api image; runs `php artisan pulse:work` to ingest the
  # sampled metrics Pulse buffers in Redis and write aggregates to Postgres.
  # Dashboard is served by api at /pulse.
  # ---------------------------------------------------------------------------
  pulse:
    image: notetify-api
    container_name: notetify-pulse
    networks:
      - notetify-net
    restart: unless-stopped
    command: ["php", "artisan", "pulse:work"]
    healthcheck:
      test: ["CMD-SHELL", "pgrep -f 'pulse:work' > /dev/null"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s
    depends_on:
      api:
        condition: service_healthy
    volumes:
      - ./api:/app
      - api_vendor:/app/vendor
      - api_storage:/app/storage
    environment:
      - DB_HOST=${DB_HOST:-db}
      - DB_PORT=${DB_PORT:-5432}
      - DB_DATABASE=${DB_DATABASE:-notetify}
      - DB_USERNAME=${DB_USERNAME:-postgres}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
      - APP_ENV=${APP_ENV:-local}
    env_file:
      - .env
    deploy:
      resources:
        limits:
          cpus: "0.5"
          memory: 256m
        reservations:
          cpus: "0.05"
          memory: 64m

  # ---------------------------------------------------------------------------
  # horizon — Laravel Horizon queue worker + supervisor
  # Reuses the api image; runs `php artisan horizon` which spawns and
  # monitors the queue worker pool defined in config/horizon.php.
  # Dashboard is served by api at /horizon.
  # ---------------------------------------------------------------------------
  horizon:
    image: notetify-api
    container_name: notetify-horizon
    networks:
      - notetify-net
    restart: unless-stopped
    command: ["php", "artisan", "horizon"]
    stop_signal: SIGTERM
    stop_grace_period: 30s
    healthcheck:
      test: ["CMD-SHELL", "pgrep -f 'artisan horizon' > /dev/null"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s
    depends_on:
      api:
        condition: service_healthy
    volumes:
      - ./api:/app
      - api_vendor:/app/vendor
      - api_storage:/app/storage
    environment:
      - DB_HOST=${DB_HOST:-db}
      - DB_PORT=${DB_PORT:-5432}
      - DB_DATABASE=${DB_DATABASE:-notetify}
      - DB_USERNAME=${DB_USERNAME:-postgres}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
      - APP_ENV=${APP_ENV:-local}
      - QUEUE_CONNECTION=${QUEUE_CONNECTION:-redis}
    env_file:
      - .env
    deploy:
      resources:
        limits:
          cpus: "1.0"
          memory: 512m
        reservations:
          cpus: "0.1"
          memory: 128m

  # ---------------------------------------------------------------------------
  # client — Vite dev server (React + Tiptap)
  # The user-facing SPA. Talks to api over HTTP and (later) to the
  # Hocuspocus service over WS for collaborative editing.
  # App: http://localhost:5173
  # ---------------------------------------------------------------------------
  client:
    build:
      context: ./client
      dockerfile: docker/Dockerfile
      target: development
    container_name: notetify-client
    networks:
      - notetify-net
    restart: unless-stopped
    command: ["pnpm","dev"]
    healthcheck:
      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:5173"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 30s
    depends_on:
      api:
        condition: service_healthy
    volumes:
      - ./client:/app
      - node_modules:/app/node_modules
    ports:
      - "5173:5173"
    environment:
      - VITE_BASE_URL=${VITE_BASE_URL:-http://localhost:8000/api/}
      - VITE_WS_ORIGIN=${VITE_WS_ORIGIN:-ws://localhost:1234}
      - VITE_APP_NAME=${VITE_APP_NAME:-Notetify}
      - VITE_CLIENT_URL=${VITE_CLIENT_URL:-http://localhost:5173/}
    env_file:
      - .env
    stdin_open: true
    tty: true
    deploy:
      resources:
        limits:
          cpus: "1.5"
          memory: 1g
        reservations:
          cpus: "0.25"
          memory: 256m

networks:
  notetify-net:
    driver: bridge

volumes:
  redis-data:
  db-data:
  node_modules:
  api_vendor:
  api_storage:
  rustfs-data:
  seq-data: