docker-compose.yml

# Local development environment for huscarl SDK contributors.
#
# Spins up a local OpenViking server so you can run integration tests
# and manual experiments without a remote deployment.
#
# Prerequisites:
#   - Copy .env.example to .env and fill in the required values.
#   - Docker Desktop (or Docker Engine + Compose plugin) installed.
#
# Usage:
#   docker compose up -d          # start in background
#   docker compose logs -f        # follow logs
#   docker compose down           # stop and remove containers
#   docker compose down -v        # also remove the persistent data volume

services:
  openviking:
    build:
      context: ./docker/openviking
      dockerfile: Dockerfile
    image: huscarl/openviking:local
    container_name: huscarl-openviking
    restart: unless-stopped
    environment:
      OPENAI_API_KEY: "${OPENAI_API_KEY}"
      OPENVIKING_SECRET_API_KEY: "${OPENVIKING_SECRET_API_KEY}"
      OPENVIKING_CONFIG_FILE: /app/ov.conf
    ports:
      # Binds only to localhost — the OpenViking server is for local dev only.
      # Connect huscarl to: http://127.0.0.1:1933
      - "127.0.0.1:1934:1934"
    volumes:
      # /app/data is the default AGFS localfs path (CWD /app + ./data from embedded-mode default).
      - openviking-data:/app/data
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:1934/health || exit 1"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 30s

volumes:
  openviking-data:
    driver: local