docker-compose.yml

name: modelport

services:
  postgres:
    # Starts only when using the internal database. When MODELPORT_DATABASE_URL
    # is set (an external PostgreSQL), this service moves to the "internal-db"
    # profile and is not started unless explicitly enabled with
    # `--profile internal-db`.
    profiles: ["${MODELPORT_DATABASE_URL:+internal-db}"]
    image: postgres:18.4-alpine
    environment:
      POSTGRES_DB: ${MODELPORT_POSTGRES_DB:-modelport}
      POSTGRES_USER: ${MODELPORT_POSTGRES_USER:-modelport}
      POSTGRES_PASSWORD: ${MODELPORT_POSTGRES_PASSWORD:?set MODELPORT_POSTGRES_PASSWORD in .env}
      PGDATA: /var/lib/postgresql/18/docker
    volumes:
      - modelport-postgres-18:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped
    stop_grace_period: ${MODELPORT_POSTGRES_STOP_GRACE_PERIOD:-1m}
    logging:
      driver: json-file
      options:
        max-size: ${MODELPORT_LOG_MAX_SIZE:-10m}
        max-file: "${MODELPORT_LOG_MAX_FILES:-5}"

  modelport:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        MODELPORT_VERSION: ${MODELPORT_VERSION:-0.1.0}
        MODELPORT_SOURCE_REVISION: ${MODELPORT_SOURCE_REVISION:-unknown}
        MODELPORT_SOURCE_STATE: ${MODELPORT_SOURCE_STATE:-unknown}
        MODELPORT_BUILD_DATE: ${MODELPORT_BUILD_DATE:-unknown}
    image: ${MODELPORT_IMAGE:-modelport:local}
    pull_policy: ${MODELPORT_PULL_POLICY:-never}
    init: true
    read_only: true
    cap_drop:
      - ALL
    security_opt:
      - no-new-privileges:true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=64m
    env_file:
      - ${MODELPORT_COMPOSE_ENV_FILE:-.env}
    environment:
      MODELPORT_BIND: 0.0.0.0:38082
      MODELPORT_ENV_FILE: /config/.env
      MODELPORT_STATE_DIR: /data
      MODELPORT_CONFIG: /config/config.toml
      MODELPORT_DATABASE_URL: ${MODELPORT_DATABASE_URL:-postgres://${MODELPORT_POSTGRES_USER:-modelport}:${MODELPORT_POSTGRES_PASSWORD:?set MODELPORT_POSTGRES_PASSWORD in .env}@postgres:5432/${MODELPORT_POSTGRES_DB:-modelport}}
      MODELPORT_TRUSTED_PROXIES: ${MODELPORT_TRUSTED_PROXIES:-127.0.0.1,::1,172.16.0.0/12}
      MODELPORT_ALLOWED_ORIGINS: ${MODELPORT_ALLOWED_ORIGINS:-}
      RUST_LOG: ${RUST_LOG:-model_port=info,tower_http=info}
    extra_hosts:
      - "host.docker.internal:host-gateway"
    ports:
      - "${MODELPORT_API_PUBLISH:-127.0.0.1:38082}:38082"
    volumes:
      - modelport-data:/data
      - type: bind
        source: ${MODELPORT_COMPOSE_ENV_FILE:-./.env}
        target: /config/.env
        read_only: true
      # Optional file-based provider config:
      - ./config.toml:/config/config.toml:ro
    # The image-level healthcheck is liveness-only. Compose overrides it with
    # authenticated storage readiness so `healthy` means the gateway may take
    # traffic. Shared deployments should issue a dedicated scoped probe key.
    healthcheck:
      test:
        - CMD-SHELL
        - >-
          probe_key="$${MODELPORT_HEALTHCHECK_API_KEY:-$${MODELPORT_AUTH_TOKEN:-}}";
          test -n "$${probe_key}" &&
          curl -fsS -H "x-api-key: $${probe_key}" http://127.0.0.1:38082/readyz >/dev/null
      interval: 15s
      timeout: 5s
      start_period: 20s
      retries: 4
    restart: unless-stopped
    # Default request timeout is 600s and finalizer drain is 30s. This window
    # lets an ordinary in-flight request finish before Docker sends SIGKILL.
    stop_grace_period: ${MODELPORT_STOP_GRACE_PERIOD:-11m}
    logging:
      driver: json-file
      options:
        max-size: ${MODELPORT_LOG_MAX_SIZE:-10m}
        max-file: "${MODELPORT_LOG_MAX_FILES:-5}"

  dashboard:
    build:
      context: .
      dockerfile: dashboard/Dockerfile
      args:
        MODELPORT_VERSION: ${MODELPORT_VERSION:-0.1.0}
        MODELPORT_SOURCE_REVISION: ${MODELPORT_SOURCE_REVISION:-unknown}
        MODELPORT_SOURCE_STATE: ${MODELPORT_SOURCE_STATE:-unknown}
        MODELPORT_BUILD_DATE: ${MODELPORT_BUILD_DATE:-unknown}
    image: ${MODELPORT_DASHBOARD_IMAGE:-modelport-dashboard:local}
    pull_policy: ${MODELPORT_PULL_POLICY:-never}
    init: true
    read_only: true
    cap_drop:
      - ALL
    security_opt:
      - no-new-privileges:true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=32m
    ports:
      - "${MODELPORT_DASHBOARD_PUBLISH:-127.0.0.1:33002}:8080"
    restart: unless-stopped
    stop_grace_period: ${MODELPORT_DASHBOARD_STOP_GRACE_PERIOD:-30s}
    logging:
      driver: json-file
      options:
        max-size: ${MODELPORT_LOG_MAX_SIZE:-10m}
        max-file: "${MODELPORT_LOG_MAX_FILES:-5}"

  ops-agent:
    profiles: ["ops-agent"]
    build:
      context: .
      dockerfile: ops-agent/Dockerfile
      args:
        MODELPORT_VERSION: ${MODELPORT_VERSION:-0.1.0}
        MODELPORT_SOURCE_REVISION: ${MODELPORT_SOURCE_REVISION:-unknown}
        MODELPORT_SOURCE_STATE: ${MODELPORT_SOURCE_STATE:-unknown}
        MODELPORT_BUILD_DATE: ${MODELPORT_BUILD_DATE:-unknown}
    image: ${MODELPORT_OPS_AGENT_IMAGE:-modelport-ops-agent:local}
    pull_policy: ${MODELPORT_PULL_POLICY:-never}
    init: true
    read_only: true
    cap_drop:
      - ALL
    security_opt:
      - no-new-privileges:true
    cpus: ${MODELPORT_OPS_CPU_LIMIT:-0.50}
    mem_limit: ${MODELPORT_OPS_MEMORY_LIMIT:-256m}
    pids_limit: ${MODELPORT_OPS_PIDS_LIMIT:-128}
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=16m
    environment:
      MODELPORT_OPS_BASE_URL: http://modelport:38082
      MODELPORT_OPS_API_KEY: ${MODELPORT_OPS_API_KEY:-}
      MODELPORT_OPS_MODEL_API_KEY: ${MODELPORT_OPS_MODEL_API_KEY:-}
      MODELPORT_OPS_MODE: ${MODELPORT_OPS_MODE:-shadow}
      MODELPORT_OPS_INTERVAL_SECONDS: ${MODELPORT_OPS_INTERVAL_SECONDS:-300}
      MODELPORT_OPS_WEBHOOK_URL: ${MODELPORT_OPS_WEBHOOK_URL:-}
      RUST_LOG: ${MODELPORT_OPS_RUST_LOG:-modelport_ops_agent=info}
    volumes:
      - modelport-ops-spool:/var/lib/modelport-ops
    depends_on:
      modelport:
        condition: service_healthy
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:38083/readyz >/dev/null"]
      interval: 30s
      timeout: 5s
      start_period: 20s
      retries: 4
    restart: unless-stopped
    stop_grace_period: 30s
    logging:
      driver: json-file
      options:
        max-size: ${MODELPORT_LOG_MAX_SIZE:-10m}
        max-file: "${MODELPORT_LOG_MAX_FILES:-5}"

volumes:
  modelport-data:
  modelport-postgres-18:
  modelport-ops-spool:

networks:
  default:
    name: ${MODELPORT_NETWORK_NAME:-modelport_default}
    external: true