# Production-like compose. Requires a populated `.env` next to this # file: at minimum POSTGRES_PASSWORD must be set to a non-default # value (the `?required` form below fails fast otherwise). The # frontend container expects HTTPS in front (Caddy/Traefik/nginx) # because COOKIE_SECURE=true browsers will refuse to send the session # cookie over plain HTTP. services: postgres: image: postgres:16-alpine environment: POSTGRES_USER: ${POSTGRES_USER:-mangalord} POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?POSTGRES_PASSWORD must be set in .env} POSTGRES_DB: ${POSTGRES_DB:-mangalord} volumes: - postgres-data:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-mangalord}"] interval: 5s timeout: 5s retries: 10 tor: # SOCKS5 proxy for the crawler, plus a control port so the backend # can signal NEWNYM on bad pages. See tor/torrc for the daemon # config; both ports are only `expose`d (compose-internal), never # bound on the host. # # We bypass dockurr/tor's stock entrypoint because it binds the # control port to localhost (unreachable from the backend # container) and skips its own HashedControlPassword injection # when the user's torrc declares a ControlPort. Our wrapper # (tor/entrypoint.sh) generates the hash from $PASSWORD and execs # tor with our torrc. Backend authenticates with the same plain # string via CRAWLER_TOR_CONTROL_PASSWORD. image: dockurr/tor:latest entrypoint: ["/bin/sh", "/usr/local/bin/mangalord-entrypoint.sh"] environment: PASSWORD: ${TOR_CONTROL_PASSWORD:?TOR_CONTROL_PASSWORD must be set in .env} volumes: - ./tor/torrc:/etc/tor/torrc:ro - ./tor/entrypoint.sh:/usr/local/bin/mangalord-entrypoint.sh:ro expose: - "9050" - "9051" # Wait for both control + SOCKS ports to listen before downstream # services start. dockurr/tor's main process spawns before tor # itself is bound, so `service_started` alone races the first # NEWNYM call. healthcheck: test: ["CMD-SHELL", "nc -z 127.0.0.1 9050 && nc -z 127.0.0.1 9051"] interval: 5s timeout: 5s retries: 20 start_period: 30s restart: unless-stopped backend: build: ./backend depends_on: postgres: condition: service_healthy tor: condition: service_healthy environment: DATABASE_URL: postgres://${POSTGRES_USER:-mangalord}:${POSTGRES_PASSWORD:?POSTGRES_PASSWORD must be set in .env}@postgres:5432/${POSTGRES_DB:-mangalord} BIND_ADDRESS: 0.0.0.0:8080 STORAGE_DIR: /var/lib/mangalord/storage RUST_LOG: ${RUST_LOG:-info,mangalord=debug} # Auth / cookies — see .env.example for context. COOKIE_SECURE: ${COOKIE_SECURE:-true} COOKIE_DOMAIN: ${COOKIE_DOMAIN:-} SESSION_TTL_DAYS: ${SESSION_TTL_DAYS:-30} # CORS — same-origin by default; populate when serving the API on # a different host than the frontend. CORS_ALLOWED_ORIGINS: ${CORS_ALLOWED_ORIGINS:-} # Upload limits. MAX_REQUEST_BYTES: ${MAX_REQUEST_BYTES:-209715200} MAX_FILE_BYTES: ${MAX_FILE_BYTES:-20971520} # System-chromium override for the crawler. Leave blank to use the # bundled fetcher; set to e.g. /usr/bin/chromium-headless-shell on # arm64 deployments. Pair with `--build-arg INSTALL_CHROMIUM=true` # so the image actually contains the binary. CRAWLER_CHROMIUM_BINARY: ${CRAWLER_CHROMIUM_BINARY:-} # TOR proxy + NEWNYM recircuit (see .env.example for details). # Defaults assume the bundled `tor` service above; override # CRAWLER_PROXY= and CRAWLER_TOR_CONTROL_URL= (both empty) in # .env to disable. CRAWLER_TOR_CONTROL_PASSWORD MUST match the # tor service's PASSWORD (both wired to the same TOR_CONTROL_PASSWORD # .env var below). CRAWLER_PROXY: ${CRAWLER_PROXY-socks5h://tor:9050} CRAWLER_TOR_CONTROL_URL: ${CRAWLER_TOR_CONTROL_URL-tcp://tor:9051} CRAWLER_TOR_CONTROL_PASSWORD: ${TOR_CONTROL_PASSWORD:?TOR_CONTROL_PASSWORD must be set in .env} CRAWLER_TOR_RECIRCUIT_MAX_ATTEMPTS: ${CRAWLER_TOR_RECIRCUIT_MAX_ATTEMPTS:-3} # Vision readiness gate (env-ONLY, not a dashboard setting). When set, # the analysis worker refuses to lease a page until this answers 2xx, so # the vision-manager autoscaler can idle-stop the vision container # without jobs burning their retries / landing `failed` rows. Leave # empty (the default) to disable the gate for an always-on endpoint. # Pair with the `ai` profile services below. See VISION-AUTOSCALE.md. ANALYSIS_VISION_HEALTH_URL: ${ANALYSIS_VISION_HEALTH_URL:-} volumes: - storage-data:/var/lib/mangalord/storage # No host port mapping in the default setup — the frontend proxies # /api/* through its hooks.server.ts. Expose :8080 only if you want # to hit the API directly from the host (e.g., bot scripts during # development). expose: - "8080" frontend: build: ./frontend depends_on: - backend environment: # SvelteKit's hooks.server.ts proxies /api/* to this URL so the # browser only ever talks to :3000 and cookies stay same-origin. BACKEND_URL: http://backend:8080 ports: - "3000:3000" # ----- Vision autoscaling (profile: ai) ----------------------------------- # Two extra containers that idle-stop the mangalord-vision (llama.cpp) # container when there is no analysis work and start it back up on demand. # Gated behind `profiles: [ai]` so a vanilla `docker compose up` is # unaffected — bring them up with `docker compose --profile ai up -d`. # The vision container itself is NOT defined here (it lives elsewhere on the # host); the manager drives it by name. See VISION-AUTOSCALE.md. # Scoped Docker access for the manager: exposes ONLY the /containers API and # write methods (start/stop) over TCP on an internal-only network. The raw # host socket is mounted HERE and nowhere else — never on the backend. docker-socket-proxy: image: tecnativa/docker-socket-proxy:latest profiles: ["ai"] environment: CONTAINERS: 1 # allow /containers/* (inspect, start, stop) POST: 1 # allow write methods (start/stop are POSTs) # Everything else stays denied (images, exec, networks, volumes, ...). volumes: - /var/run/docker.sock:/var/run/docker.sock:ro networks: - vision-internal restart: unless-stopped vision-manager: build: ./vision-manager profiles: ["ai"] depends_on: postgres: condition: service_healthy docker-socket-proxy: condition: service_started environment: # Read-only role — apply vision-manager/readonly-role.sql once, then set # VISION_MANAGER_DATABASE_URL in .env. Do NOT reuse the backend creds. DATABASE_URL: ${VISION_MANAGER_DATABASE_URL:?set VISION_MANAGER_DATABASE_URL in .env (vision_manager read-only role)} VISION_CONTAINER: ${VISION_CONTAINER:-mangalord-vision} VISION_HEALTH_URL: ${VISION_HEALTH_URL:-http://mangalord-vision:8000/health} DOCKER_HOST: tcp://docker-socket-proxy:2375 POLL_INTERVAL: ${VISION_POLL_INTERVAL:-20} STOP_DEBOUNCE: ${VISION_STOP_DEBOUNCE:-600} START_HEALTH_TIMEOUT: ${VISION_START_HEALTH_TIMEOUT:-300} RESPECT_CRAWL_MUTEX: ${VISION_RESPECT_CRAWL_MUTEX:-1} MAX_UPTIME: ${VISION_MAX_UPTIME:-0} networks: - default # reach postgres + the vision container by name - vision-internal # reach the socket-proxy restart: unless-stopped networks: default: # Internal-only: no route to the outside world. Only the manager and the # socket-proxy sit on it, so nothing else can reach the Docker API. vision-internal: internal: true volumes: postgres-data: storage-data: