Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A dashboard for managing RQ in the Django admin

branch: master
README.rst

Django-rq-dashboard

RQ is a simple task queue for queuing and processing jobs. django-rq-dashboard is a web frontend to monitor your RQ queues, jobs and workers in realtime from the Django admin. It looks like this:

http://cloud.github.com/downloads/brutasse/django-rq-dashboard/stats.png

See also screenshots of the Worker, Queue and Job pages.

It is very much inspired from the Flask-powered rq-dashboard.

Installation

  • pip install django-rq-dashboard

  • Add django_rq_dashboard to your INSTALLED_APPS

  • Add the URL patterns in you URLconf:

    urlpatterns = patterns('',
        (r'^admin/rq/', include('django_rq_dashboard.urls')),
        # your own patterns follow…
    )
    
  • (optional if non-default values) configure Redis access in your settings. Just define a dictionnary that can be used to construct a Redis object. All key are optional and their default values are:

    RQ = {
        'host': 'localhost',
        'port': 6379,
        'db': 0,
        'password': None,
        'socket_timeout': None,
        'connection_pool': None,
        'charset': 'utf-8',
        'errors': 'strict',
        'decode_responses': False,
        'unix_socket_path': None,
    }
    
  • Run the development server, queue some jobs, fire off some workers and go watch http://localhost:8000/admin/rq/

Something went wrong with that request. Please try again.