Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

rq-scheduler-dashboard is a copy of rq-dashboard for rq-scheduler jobs, based on the code from this PR:

Project Description

rq-scheduler-dashboard is a copy of rq-dashboard for rq-scheduler jobs, based on the code from this PR: This just wraps the code from @helenst into a separate package.

It looks like this


$ pip install rq-scheduler-dashboard

Running the dashboard

Run the dashboard standalone, like this:

$ rq-scheduler-dashboard
* Running on
$ rq-scheduler-dashboard --help
Usage: rq-scheduler-dashboard [OPTIONS]

  Run the RQ Scheduler Dashboard Flask server.

  All configuration can be set on the command line or through environment

  A subset of the configuration (the configuration parameters used by the
  underlying flask blueprint) can also be provided in a Python module
  referenced using --config, or with a .cfg file referenced by the

  -b, --bind TEXT               IP or hostname on which to bind HTTP server
  -p, --port INTEGER            Port on which to bind HTTP server
  --url-prefix TEXT             URL prefix e.g. for use behind a reverse proxy
  --username TEXT               HTTP Basic Auth username (not used if not set)
  --password TEXT               HTTP Basic Auth password
  -c, --config TEXT             Configuration file (Python module on search
  -H, --redis-host TEXT         IP address or hostname of Redis server
  -P, --redis-port INTEGER      Port of Redis server
  --redis-password TEXT         Password for Redis server
  -D, --redis-database INTEGER  Database of Redis server
  -u, --redis-url TEXT          Redis URL connection (overrides other
                                individual settings)
  --interval INTEGER            Refresh interval in ms
  --help                        Show this message and exit.

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

app = Flask(__name__)

def hello():
    return "Hello World!"

if __name__ == "__main__":

The 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 Scheduler Dashboard is currently being developed and is in beta stage.

Release History

This version
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.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(92.7 kB) Copy SHA256 Hash SHA256
Source None Apr 4, 2017

Supported By

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 Google Google Cloud Servers