Docker Deployment

Single container

docker build -t recursive:dev --target runtime .
docker run -p 3000:3000 \
  -e RECURSIVE_API_KEY="$OPENAI_API_KEY" \
  -e RECURSIVE_API_BASE="https://api.openai.com/v1" \
  -e RECURSIVE_MODEL="gpt-4o-mini" \
  recursive:dev

The image defaults to recursive http --addr 0.0.0.0:3000 and exposes /health for probes.

Docker Compose (Redis + S3)

cp .env.example .env    # fill in RECURSIVE_API_KEY
docker compose up

The bundled docker-compose.yml spins up:

• recursive — the HTTP API server (port 3000)
• redis — session hot-state
• localstack — S3-compatible transcript persistence (for local development)

Environment variables

Set these in your .env or Docker run command:

RECURSIVE_API_KEY=sk-...
RECURSIVE_API_BASE=https://api.openai.com/v1
RECURSIVE_MODEL=gpt-4o-mini
RECURSIVE_HTTP_ADDR=0.0.0.0:3000

For cloud storage, also set:

RECURSIVE_REDIS_URL=redis://redis:6379
RECURSIVE_S3_BUCKET=my-recursive-bucket
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AWS_DEFAULT_REGION=us-east-1

Health probe

curl http://localhost:3000/health
# → "ok"

Use this as the Docker health check:

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
  interval: 30s
  timeout: 5s
  retries: 3