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.

Installation

Configuration

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 manage.py migrate kombu_transport_django

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

   $ python manage.py syncdb

Limitations

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).