1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# VelaClaw Docker Compose Example
#
# Quick start:
# 1. Copy this file and set your API key
# 2. Run: docker compose up -d
# 3. Access gateway at http://localhost:3000
#
# For more info: https://github.com/velaclaw-labs/velaclaw
services:
velaclaw:
image: ghcr.io/velaclaw-labs/velaclaw:latest
# Or build locally:
# build: .
container_name: velaclaw
restart: unless-stopped
environment:
# Required: Your LLM provider API key
- API_KEY=${API_KEY:-}
# Or use the prefixed version:
# - VELACLAW_API_KEY=${VELACLAW_API_KEY:-}
# Optional: LLM provider (default: openrouter)
# Options: openrouter, openai, anthropic, ollama
- PROVIDER=${PROVIDER:-openrouter}
# Allow public bind inside Docker (required for container networking)
- VELACLAW_ALLOW_PUBLIC_BIND=true
# Optional: Model override
# - VELACLAW_MODEL=anthropic/claude-sonnet-4-20250514
volumes:
# Persist workspace and config (must match WORKDIR/HOME in Dockerfile)
- velaclaw-data:/velaclaw-data
ports:
# Gateway API port (override HOST_PORT if 3000 is taken)
- "${HOST_PORT:-3000}:3000"
# Resource limits
deploy:
resources:
limits:
cpus: '2'
memory: 2G
reservations:
cpus: '0.5'
memory: 512M
# Health check — uses lightweight status instead of full diagnostics.
# For images with curl, prefer: curl -f http://localhost:3000/health
healthcheck:
test: ["CMD", "velaclaw", "status"]
interval: 60s
timeout: 10s
retries: 3
start_period: 10s
volumes:
velaclaw-data: