This document describes Celery 2.4. For development docs, go here.

Using CouchDB

Installation

For the CouchDB support you have to install additional dependencies. You can install both Celery and these dependencies in one go using either the celery-with-couchdb, or the django-celery-with-couchdb bundles:

$ pip install -U celery-with-couchdb

Configuration

Configuration is easy, set the transport, and configure the location of your CouchDB database:

BROKER_URL = "couchdb://localhost:5984/database_name"

Where the URL is in the format of:

couchdb://userid:password@hostname:port/database_name

The host name will default to localhost and the port to 5984, and so they are optional. userid and password are also optional, but needed if your CouchDB server requires authentication.

Results

Storing task state and results in CouchDB is currently not supported.

Limitations

The Beanstalk message transport does not currently support:

• Remote control commands (celeryctl, broadcast)