GitHub - srijanpatel/arq-dashboard: A dashboard for ARQ built with FastAPI

A monitoring dashboard for ARQ (async Redis job queue).

Quick start

docker run --rm --network host \
  -e ARQ_DASHBOARD_REDIS_URL=redis://localhost:6379 \
  ghcr.io/srijanpatel/arq-dashboard:latest

Open http://localhost:8000. Or launch the TUI:

docker run --rm -it --network host \
  -e ARQ_DASHBOARD_REDIS_URL=redis://localhost:6379 \
  ghcr.io/srijanpatel/arq-dashboard tui

--network host is native on Linux. On Docker Desktop (Mac/Windows) enable it in Settings → Resources → Network → "Enable host networking".

Features

Queue overview — queued, in-progress, deferred, complete job counts
Function performance — success rates, runtime percentiles (p50/p95/p99)
Runtime distribution charts and success/failure breakdown
Throughput metrics — jobs/min, last 5 minutes, last hour
Auto-refresh (10s / 30s / 60s)
Job list with filtering by function, status, time range
Job detail with visual enqueue → start → finish timeline
Dark / light mode with system preference detection
Terminal UI (arq-dashboard tui) — same data, no browser needed

Terminal UI

Configuration

Variable	Default	Description
`ARQ_DASHBOARD_REDIS_URL`	`redis://localhost:6379`	Redis connection URL
`ARQ_DASHBOARD_CACHE_TTL`	`60`	API cache TTL in seconds
`ARQ_DASHBOARD_DEBUG`	`false`	Debug mode
`ARQ_DASHBOARD_LOG_LEVEL`	`DEBUG`	Log level

Development

Requires Python 3.11+, Node.js 18+, Redis, and uv.

make install        # Install all dependencies
make dev-backend    # Backend on :8000
make dev-frontend   # Frontend on :5173 (proxies to backend)
make test           # Run all tests
make lint           # Lint all code

License

MIT

Forked from ninoseki/arq-dashboard and ninoseki/arq-dashboard-frontend by @ninoseki.