This document describes the current stable version of Celery (3.1). For development docs, go here.

Using the Django Database

Experimental Status

The Django database transport is in need of improvements in many areas and there are several open bugs. Unfortunately we don’t have the resources or funds required to improve the situation, so we’re looking for contributors and partners willing to help.



The database transport uses the Django DATABASE_* settings for database configuration values.

  1. Set your broker transport:

    BROKER_URL = 'django://'
  2. Add kombu.transport.django to INSTALLED_APPS:

    INSTALLED_APPS = ('kombu.transport.django', )
  3. Sync your database schema:

   $ python migrate kombu_transport_django

Or if you are using a version of Django lower than 1.7

   $ python syncdb


The Django database transport does not currently support:

  • Remote control commands (celery events command, broadcast)
  • Events, including the Django Admin monitor.
  • Using more than a few workers (can lead to messages being executed multiple times).