ServicesDocker
Docker
Docker Compose for development and multi-stage Dockerfile for production.
The Docker service provides both the local development environment and the production container image for the Agent.
Docker Compose (services/docker/docker-compose.yml)
Two services run in development:
| Service | Description |
|---|---|
sherpa | Agent app with hot reload, source code mounted, persistent volume at .volumes/root-dev |
hookdeck | Hookdeck CLI sidecar that tunnels Basecamp webhooks to http://sherpa:3000/webhooks |
Dockerfile (services/docker/Dockerfile)
Multi-stage build producing a minimal production image:
| Stage | What it does |
|---|---|
deps | Base Node.js 22 + pnpm |
dev | Adds Claude Code CLI, Basecamp CLI, git, curl |
build | Compiles the Vite SSR bundle |
runtime | Production image with Node.js 22, CLIs, built bundle, health check at /health |
Key paths
| Path | Description |
|---|---|
services/docker/docker-compose.yml | Development compose file |
services/docker/Dockerfile | Multi-stage production build |
.volumes/root-dev/ | Persistent credentials volume (gitignored) |