Docker Compose Quickstart

Get a local Dreadnode stack running quickly with Docker Compose and just.

Prerequisites

• Docker (20.10+)
• Docker Compose (v2)
• Node.js 20+
• Git

5-minute setup

git clone https://github.com/dreadnode/dreadnode-tiger.git
cd dreadnode-tiger

# One-command bootstrap
just setup

# Start the full stack
just dev

What just setup does

• Installs dependencies for API, SDK, Dreadnode agent, and frontend
• Generates platform/envs/local.env with random secrets if it doesn’t exist
• Starts Postgres, MinIO, ClickHouse, and LiteLLM with Docker Compose
• Runs database migrations

Verify the stack is running

• Frontend: http://localhost:5173
• API (direct): http://localhost:8000
• Full stack (proxy): http://localhost:3000

Manual Docker Compose steps (no just)

If you don’t use just, run the infrastructure and services manually.

1) Start infrastructure services

cd packages/api
docker compose up -d postgres minio clickhouse

2) Run migrations

cd ../..
just migrate

3) Start API and frontend (separate terminals)

cd packages/api
PYTHONPATH=../.. ENV_FILE=../../platform/envs/local.env uv run uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

cd packages/frontend
npm install
npm run dev

Troubleshooting

• Ports already in use: stop any existing services on 3000, 8000, or 5173.
• Docker not running: ensure Docker Desktop or the daemon is started.
• Missing env file: copy platform/envs/local.example.env to platform/envs/local.env or rerun just setup.