Docker Deployment

GridWork HQ includes a Dockerfile and docker-compose.yml for container-based deployment. Docker support was added in v1.2.0.

Prerequisites

• Docker 20.10+ installed
• Docker Compose v2+ installed
• API keys and accounts ready (see Prerequisites)

Quick Start

cd ~/agency-workspace

# Run the setup wizard first to generate .env files
cd gridwork-hq
node setup-wizard.mjs
cd ..

# Build and start
docker compose build
docker compose up -d

The dashboard will be available at http://localhost:3000 and the pipeline server at http://localhost:8750.

Configuration

Before building, ensure your environment files are in place:

• gridwork-hq/.env.local — dashboard environment variables
• pipeline-server/.env — pipeline server environment variables

The setup wizard creates both files. If you need to configure them manually, copy from the templates:

cp gridwork-hq/.env.template gridwork-hq/.env.local
cp pipeline-server/.env.template pipeline-server/.env

Then edit each file with your API keys and settings.

Volume Mounts

The Docker Compose configuration mounts these directories for persistence:

• SQLite database — ./data/ for the gridwork-hq.db file
• Knowledge vault — your knowledge directory (configured via KNOWLEDGE_DIR)
• Pipeline output — .output/ directory for pipeline results

Viewing Logs

# All services
docker compose logs -f

# Dashboard only
docker compose logs -f gridwork-hq

# Pipeline server only
docker compose logs -f pipeline-server

Updating

# Pull latest changes
git pull origin main

# Rebuild and restart
docker compose build
docker compose up -d

Notes

• The Claude Code CLI must be available inside the pipeline server container for pipelines to execute
• For production use, place Nginx or a reverse proxy in front of the containers for SSL termination
• The pipeline server container needs network access to reach Notion, GitHub, and Anthropic APIs

For a more flexible deployment, consider the VPS or Vercel + Tailscale options.