Deployment
Standalone Docker
Run Workbench as a standalone Bun server in Docker without embedding it in your app.
Run Workbench without embedding it in your application server — useful for Kubernetes sidecars, ops dashboards, and teams that want queue visibility without touching app code.
Quick run
Shell
docker run --rm -p 3000:3000 \
-e REDIS_URL=redis://host.docker.internal:6379 \
-e QUEUE_NAMES=default \
ghcr.io/pontusab/workbench-standalone:latestOpen http://localhost:3000.
Build from source
From the monorepo root:
Shell
docker build -f apps/standalone/Dockerfile -t workbench-standalone .Environment variables
| Variable | Default | Description |
|---|---|---|
REDIS_URL | — | Redis connection URL |
QUEUE_NAMES | default | Comma-separated queue names |
PORT | 3000 | HTTP port |
BASE_PATH | / | Dashboard base path |
AUTH_USERNAME | — | Basic auth username |
AUTH_PASSWORD | — | Basic auth password |
TITLE | Workbench | Dashboard title |
LOGO_URL | — | Logo URL |
READONLY | false | Disable write actions |
TAGS | — | Comma-separated tag fields |
Unauthenticated mode is allowed when AUTH_USERNAME and AUTH_PASSWORD are unset — use only for local development.
Health check
Shell
curl http://localhost:3000/healthcheckLocal development
Shell
docker compose up -d redis
REDIS_URL=redis://localhost:6379 bun run --filter @getworkbench/standalone devImage publishing
GitHub Actions publishes versioned images to GHCR:
Code
ghcr.io/<owner>/workbench-standalone:<version>
ghcr.io/<owner>/workbench-standalone:latestSee Environment variables for the full reference.