rq-dashboard

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 on this page — 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

rq-dashboard on PyPI

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

Evidence: rq_dashboard-0.9.0-py2.py3-none-any.whl

Tags

More Scientific/Engineering packages