docker

name	docker
description	Manage the workflow engine's Docker Compose stack. Use when starting, stopping, rebuilding containers, or resetting the database.

Profiles

Profile	Services
app	workflow-engine + postgres
dashboard	dashboard
full	everything (engine + postgres + dashboard + monitoring + mocks)

Common commands

Start a profile:

docker compose --profile <profile> up -d

Rebuild and deploy the engine:

docker compose build workflow-engine && docker compose --profile app up -d --no-deps workflow-engine

Rebuild and deploy the dashboard:

docker compose build dashboard && docker compose --profile dashboard up -d --no-deps dashboard

Stop everything:

docker compose --profile full down

View container status:

docker compose ps

View logs for a specific service:

docker compose logs -f <service-name>

Container reference

Container	Port(s)	Purpose
workflow-engine	8080, 8081	API
dashboard	8090	Monitoring UI
postgres	5433	Database
pgadmin	5050	PostgreSQL admin UI
lgtm	7070, 4317, 4318	Grafana + Prometheus + Loki + Tempo + OTLP
blackbox-exporter	—	Prometheus blackbox exporter
postgres-exporter	9187	Prometheus PostgreSQL exporter
wiremock	6060	Mock app callbacks

Database reset

Truncate all workflow data (requires running postgres container):

docker compose exec postgres psql -U postgres -d workflow_engine -c 'TRUNCATE "Workflows", "Steps" CASCADE;'

Notes

• Dashboard wwwroot/ is bind-mounted — frontend file edits are live without rebuild (just browser refresh, or automatic via hot-reload).
• The engine can be run on the host from the workflow-engine-app directory with dotnet run --project src/WorkflowEngine.App (requires postgres container).