---
id: rq-dashboard
version: "0.9.0"
license: BSD
license_treatment: permissive
maintenance: active
---

# rq-dashboard — rq-dashboard is a general purpose, lightweight, web interface to monitor your RQ queues, jobs, and workers in realtime.

License: permissive · Maintenance: active · Downloads: 434.2K/mo

## What it is and what it does

rq-dashboard is a lightweight web interface built on Flask that lets you monitor RQ (Redis Queue) jobs, workers, and queues in real time. It runs as either a standalone CLI service listening on port 9181 by default, or as a Flask blueprint you can embed in your own application. The dashboard connects to Redis via configurable URLs and displays queue status, job details, and worker health.

The package depends on rq, Flask, redis, arrow (for time formatting), and redis-sentinel-url (for Sentinel support). It supports deployment as a Docker container, behind reverse proxies like NGINX, or as a systemd service. Configuration is handled via command-line flags or environment variables prefixed with RQ_DASHBOARD_. The project is actively maintained but remains in beta, so you may encounter breaking changes or incomplete features.

Use it for:

- Monitor background job progress and status in development or production RQ deployments without writing custom monitoring code.
- Inspect failed or stuck jobs in Redis queues and manually trigger cleanup or retries from the web UI.
- Run the dashboard as an isolated Docker service to keep monitoring dependencies separate from your main application stack.
- Integrate queue monitoring into an existing Flask application by mounting the dashboard blueprint at a custom URL prefix.
- Debug worker availability and job queue depth in real time during development or incident response.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Flask-based web dashboard for monitoring RQ job queues, workers, and jobs in real time, deployable as a standalone service or integrated into an existing Flask application.

Yes, if you use RQ for background jobs and want a ready-made monitoring interface. Install friction is low and maintenance is active. The beta status means you should test it in a non-critical environment first and be prepared for potential API changes, but the project has been around since 2012 and is actively developed. No known security vulnerabilities.

## Install

pip install rq-dashboard
uv add rq-dashboard
poetry add rq-dashboard

## Installing rq-dashboard

Before you install: Low friction install with a pure-Python wheel. Active maintenance with a recent release 43 days ago and steady repository activity. Currently in beta stage according to the project.

License in practice: BSD license (permissive) places no restrictions on use or redistribution in your own projects.

Quickstart:

pip install rq-dashboard

# Standalone: run the CLI
rq-dashboard

# Or integrate into Flask:
from flask import Flask
import rq_dashboard

app = Flask(__name__)
app.config.from_object(rq_dashboard.default_settings)
rq_dashboard.web.setup_rq_connection(app)
app.register_blueprint(rq_dashboard.blueprint, url_prefix="/rq")

Verify before relying:

- Specific Python version requirements (classifiers list 3.5–3.7 but requires_python is unspecified)
- Whether the beta status affects production readiness or indicates active breaking changes

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 434.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

rq queue monitoring dashboard, redis queue web interface, job queue real-time monitoring, rq worker status dashboard, background job queue visualization, job-queue-monitoring, redis-queue, flask-dashboard

[View on SkillFed](https://skillfed.io/packages/rq-dashboard) · [View on PyPI](https://pypi.org/project/rq-dashboard/)