Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

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

Project Description

rq-dashboard is a general purpose, lightweight, Flask-based web front-end to monitor your RQ queues, jobs, and workers in realtime.

It looks like this


$ pip install rq-dashboard

Running the dashboard

Run the dashboard standalone, like this:

$ rq-dashboard
* Running on
$ rq-dashboard --help
RQ Dashboard version 0.3.5
Usage: rq-dashboard [options]

  -h, --help            show this help message and exit
  -b ADDR, --bind=ADDR  IP addr or hostname to bind to
  -p PORT, --port=PORT  port to bind to
                        url prefix e.g. for hosting behind reverse proxy
  --username=USERNAME   HTTP Basic Auth username
  --password=PASSWORD   HTTP Basic Auth password
                        configuration file
  -H ADDR, --redis-host=ADDR
                        IP addr or hostname of Redis server
  -P REDIS_PORT, --redis-port=REDIS_PORT
                        port of Redis server
                        password for Redis server
  -D DB, --redis-database=DB
                        database of Redis server
  -u REDIS_URL, --redis_url=REDIS_URL
                        redis url connection
                        refresh interval in ms

Integrating the dashboard in your Flask app

The dashboard can be integrated in to your own Flask app by accessing the blueprint directly in the normal way, e.g.:

from flask import Flask
import rq_dashboard

app = Flask(__name__)

def hello():
    return "Hello World!"

if __name__ == "__main__":

The scripts/ entry point provides a simple working example.


We use piptools to keep our development dependencies up to date

$ pip install --upgrade pip
$ pip install git+

Now make changes to the file, and resolve all the 2nd-level dependencies into requirements.txt like so:

$ pip-compile --annotate

Develop in a virtualenv and make sure you have all the necessary build time (and run time) dependencies with

$ pip install -r requirements.txt

Develop in the normal way with

$ python develop

Then use Fabric to perform various development tasks. For example, to tag, build and upload to testpypi

$ git tag 0.3.5   # no 'v' prefix or anything
$ fab build
$ fab upload

This requires write access to both the GitHub repo and to the PyPI test site.

See fab -l for more options and fab -d <subcommand> for details.

Maturity notes

The RQ dashboard is currently being developed and is in beta stage.

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(98.8 kB) Copy SHA256 Hash SHA256
2.7 Wheel Jun 6, 2015
(92.9 kB) Copy SHA256 Hash SHA256
Source Jun 6, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting