Skip to content
PgWorkflows

Dashboard

A read-only web UI over the PgWorkflows tables: a live run feed with status filters and a per-run view of steps, timers, signal waits, and failure hooks. It talks straight to your Postgres and needs nothing else.

Run it

Section titled “Run it”

The image is published to GitHub Container Registry:

Terminal window
docker run -p 3000:3000 \
  -e DATABASE_URL=postgres://user:pass@host:5432/yourdb \
  ghcr.io/edrasmussen/pgworkflows-dashboard

Then open http://localhost:3000. DATABASE_URL is the only configuration. Point it at the database your workers use. The dashboard only reads, so use a read-only role. It displays workflow and activity inputs, outputs, and errors, which may contain sensitive data. The image does not provide an application security boundary for those payloads; protect it with your deployment’s authentication and network controls, and avoid persisting secrets or unnecessary personal data.

The repo’s docker compose up --build -d starts it alongside the example stack.