Skip to main content

Redis Cache Backend for Django

Project description

A cache backend for Django using the Redis datastructure server.



  • Adds custom has_key implementation that uses Redis’s exists command.
    This will speed has_key up drastically if the key under question is extremely large.


  • Keys can now be kept alive indefinitely by setting the timeout to None,
    e.g. cache.set('key', 'value', timeout=None)
  • Adds ttl method to the cache. cache.ttl(key) will return the number of
    seconds before it expires or None if the key is not volitile.


  • Allows user to specify the connection pool class kwargs, e.g. timeout,
    max_connections, etc.


  • Adds support for specifying the connection pool class.
  • Adds ability to set the max connections for the connection pool.


Adds Support for Python 3.3 and Django 1.5 and 1.6. Huge thanks to Carl Meyer for his work.


Redis cache now allows you to use either a TCP connection or Unix domain socket to connect to your redis server. Using a TCP connection is useful for when you have your redis server separate from your app server and/or within a distributed environment. Unix domain sockets are useful if you have your redis server and application running on the same machine and want the fastest possible connection.

You can now specify (optionally) what parser class you want redis-py to use when parsing messages from the redis server. redis-py will pick the best parser for you implicitly, but using the PARSER_CLASS setting gives you control and the option to roll your own parser class if you are so bold.


This cache backend requires the redis-py Python client library for communicating with the Redis server.

Redis writes to disk asynchronously so there is a slight chance of losing some data, but for most purposes this is acceptable.

In order to use redis.connection.HiredisParser parser class, you need to pip install hiredis. This is the recommended parser class.


  1. Run python install to install, or place redis_cache on your Python path.
  2. Modify your Django settings to use redis_cache :

On Django < 1.3:

CACHE_BACKEND = 'redis_cache.cache://<host>:<port>'

On Django >= 1.3:

# When using TCP connections
    'default': {
        'BACKEND': 'redis_cache.RedisCache',
        'LOCATION': '<host>:<port>',
        'OPTIONS': {
            'DB': 1,
            'PASSWORD': 'yadayada',
            'PARSER_CLASS': 'redis.connection.HiredisParser',
            'CONNECTION_POOL_CLASS': 'redis.BlockingConnectionPool',
                'max_connections': 50,
                'timeout': 20,

# When using unix domain sockets
# Note: ``LOCATION`` needs to be the same as the ``unixsocket`` setting
# in your redis.conf
    'default': {
        'BACKEND': 'redis_cache.RedisCache',
        'LOCATION': '/path/to/socket/file',
        'OPTIONS': {
            'DB': 1,
            'PASSWORD': 'yadayada',
            'PARSER_CLASS': 'redis.connection.HiredisParser'

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-redis-cache, version 0.13.0
Filename, size File type Python version Upload date Hashes
Filename, size django-redis-cache-0.13.0.tar.gz (7.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page