docker-compose.yml

# Ironclaw Quickstart
# 1. cp .env.example .env   (fill in your LLM provider credentials)
# 2. docker compose up -d
# 3. Ironclaw is available at http://localhost:3333

services:
  ironclaw-postgres:
    image: pgvector/pgvector:pg16
    container_name: ironclaw-postgres
    environment:
      POSTGRES_DB: ironclaw
      POSTGRES_USER: ironclaw
      POSTGRES_PASSWORD: ${IRONCLAW_DB_PASSWORD:-ironclaw}
    volumes:
      - ironclaw_postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ironclaw -d ironclaw"]
      interval: 10s
      timeout: 5s
      retries: 5

  ironclaw:
    build:
      context: ./ironclaw
    container_name: ironclaw
    restart: unless-stopped
    ports:
      - "3333:8080"
    environment:
      # LLM provider — Anthropic (API key or OAuth) or NEAR AI
      LLM_BACKEND: anthropic
      ANTHROPIC_OAUTH_TOKEN: ${ANTHROPIC_OAUTH_TOKEN:-}
      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
      ANTHROPIC_MODEL: claude-sonnet-4-6
      NEARAI_API_KEY: ${NEARAI_API_KEY:-}
      # Database (ironclaw's own pgvector instance)
      DATABASE_URL: postgresql://ironclaw:${IRONCLAW_DB_PASSWORD:-ironclaw}@ironclaw-postgres:5432/ironclaw
      # HTTP webhook server
      HTTP_HOST: 0.0.0.0
      HTTP_PORT: "8080"
      HTTP_WEBHOOK_SECRET: ${IRONCLAW_SHARED_SECRET:-change-me}
      # Agent settings
      AGENT_NAME: ironclaw
      AGENT_USE_PLANNING: "true"
      RUST_LOG: ironclaw=info
    volumes:
      - ironclaw-data:/home/ironclaw/.ironclaw
    depends_on:
      ironclaw-postgres:
        condition: service_healthy

volumes:
  ironclaw_postgres_data:
  ironclaw-data: