Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Redis monitoring and inspection drop-in application using django admin.

Project description

Redis monitoring and inspection drop-in application using django admin.

  • Free software: BSD 2-Clause License


  • Sever statistics in the admin changelist
  • Key summary in the inspect view
  • Value introspection with pagination for lists and sorted sets


Runtime:Python 2.7, 3.4, 3.4 or PyPy
Services:Redis 2.2 or later.
Packages:Django>=1.8, py-redis>=2.10.0

Don’t have a django project?

If you just want to run redisboard quickly do this:

pip install django-redisboard

Don’t want to run on Run:

redisboard ip:port

Want a password that ain’t random (you might need to rm -rf ~/.redisboard first tho)? Run:

redisboard --password=foobar

Installation guide

Install from pypi, with pip:

pip install django-redisboard

Or with setuptools:

easy_install django-redisboard

Add redisboard to INSTALLED_APPS:

INSTALLED_APPS += ("redisboard", )

After that you need to run: migrate

Then you can add redis servers in the admin. You will see the stats in the changelist.

Redisboard has few css tweaks for the pages (they are optional). If you use staticfiles just run: collectstatic

If you do not use django.contrib.staticfiles you must manually symlink the site-packages/redisboard/static/redisboard dir to <your media root>/redisboard.

Optional django settings


REDISBOARD_DETAIL_FILTERS - a list of regular expressions to match against the keys in the server details colum. Eg, to only show uptime and list of active databases:

REDISBOARD_DETAIL_FILTERS = ['uptime.*', 'db.*']

To show all the details just use:



REDISBOARD_ITEMS_PER_PAGE - default 100. Used for paginating the items from a list or a sorted set.


REDISBOARD_SOCKET_TIMEOUT - default None. Socket operations time out after this many seconds.


REDISBOARD_SOCKET_CONNECT_TIMEOUT - default None. Socket connect operation times out after this many seconds.


REDISBOARD_SOCKET_KEEPALIVE - default None. Enables or Disables socket keepalive.


REDISBOARD_SOCKET_KEEPALIVE_OPTIONS - default None. Additional options for socket keepalive.




Inspect key details:


To run the all tests run:



4.1.1 (2020-07-28)

  • Improved exception handling for errors coming from redis. Now timeouts show the server as “DOWN” and other errors don’t result in a 500 page.

4.1.0 (2020-07-23)

  • Fixed a KeyError that could occur on fast changing databases. Contributed by Rand01ph in #39.
  • Added a port filter. Contributed by Rick van Hattem in #41.
  • Added support for Django 3. Contributed by Alireza Amouzadeh in #43.
  • Fixed issues that could occur when running the redisboard CLI with newer Django (migrations will run now).
  • Fixed ugettext deprecation.
  • Added a favicon.ico and handler in the redisboard CLI.

4.0.0 (2018-11-01)

  • Fixed typo in inspect.html template to reflect out.
  • Added Django 2.0 support. Contributed by Erik Telepovský in #33.
  • Converted the script to a redisboard bin and fixed Django 2.x issues.
  • Dropped support for Django older than 1.11.
  • Dropped support for Python older than 3.4 or 2.7.
  • Fixed issues with data being displayed as binary strings.
  • Fixed unwanted tag escaping. Contributed by Gilles Lavaux in #37.

3.0.2 (2017-01-19)

  • Fixed UnicodeDecodeError in “redisboard/” (fixes issue #15). Contributed by Erik Telepovský in #29.
  • Fixed TypeError in “redisboard/”. Contributed by gabn88 in #28.

3.0.1 (2016-09-12)

  • Add supportfor Django 1.10. Contributed by Vincenzo Demasi in #26.

3.0.0 (2015-12-17)

  • Drop support for Django < 1.8
  • Add support for Django 1.9. Contributed by gabn88 in #25.

2.0.0 (2015-11-08)

  • Fix error handling in couple places. Now pages don’t return 500 errors if there’s something bad going on with the redis connection.
  • Remove key stats that came from DEBUG OBJECT (LRU, Address, Length etc). Now OBJECT [REFCOUNT|ENCODING|IDLETIME] is used instead. BACKWARDS INCOMPATIBLE

1.2.2 (2015-10-11)

  • Exception handling for AWS ElastiCache Redis or any Redis that does not have DEBUG OBJECT command.
  • Enabled Redis keys to be inspected despite not having details from DEBUG OBJECT command.

1.2.1 (2015-06-30)

  • Fixed a bug on Python 3 (no xrange).
  • Fixed some issues the bootstrapper had with virtualenv.

1.2.0 (2015-02-21)


1.1.0 (2015-01-21)

  • Fix broken slowlog display.

1.0.0 (2014-12-10)

  • Show slowlog and cpu usage and more memory stats (contributed by Rick van Hattem)
  • Use pipelines to send commands for faster response (contributed by Rick van Hattem)
  • Added Python 3.3 and 3.4 support.
  • Added a test suite and other minor fixes.

0.2.7 (?)

  • N/A.

Project details

Download files

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

Files for django-redisboard, version 4.1.1
Filename, size File type Python version Upload date Hashes
Filename, size django_redisboard-4.1.1-py2.py3-none-any.whl (46.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size django-redisboard-4.1.1.tar.gz (311.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page