Getting started

To use django-celery-results with your project you need to follow these steps:

1. Install the django-celery-results library:

   $ pip install django-celery-results
   

2. Add django_celery_results to INSTALLED_APPS in your Django project’s settings.py:

   INSTALLED_APPS = (
       ...,
       'django_celery_results',
   )
   

   Note that there is no dash in the module name, only underscores.

3. Create the Celery database tables by performing a database migrations:

   $ python manage.py migrate django_celery_results
   

4. Configure Celery to use the django-celery-results backend.

   Assuming you are using Django’s settings.py to also configure Celery, add the following settings:

   CELERY_RESULT_BACKEND = 'django-db'
   

   For the cache backend you can use:

   CELERY_CACHE_BACKEND = 'django-cache'
   

   We can also use the cache defined in the CACHES setting in django.

   # celery setting.
   CELERY_CACHE_BACKEND = 'default'
   
   # django setting.
   CACHES = {
       'default': {
           'BACKEND': 'django.core.cache.backends.db.DatabaseCache',
           'LOCATION': 'my_cache_table',
       }
   }
   

   If you want to include extended information about your tasks remember to enable the result_extended setting.

   CELERY_RESULT_EXTENDED = True