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

Using IronMQ


For IronMQ support, you’ll need the [iron_celery]( library:

$ pip install iron_celery

As well as an [ account]( Sign up for free at [](


First, you’ll need to import the iron_celery library right after you import Celery, for example:

from celery import Celery
import iron_celery

app = Celery('mytasks', broker='ironmq://', backend='ironcache://')

You have to specify IronMQ in the broker URL:


where the URL format is:


you must remember to include the “@” at the end.

The login credentials can also be set using the environment variables IRON_TOKEN and IRON_PROJECT_ID, which are set automatically if you use the IronMQ Heroku add-on. And in this case the broker url may only be:



The default cloud/region is AWS us-east-1. You can choose the IronMQ Rackspace (ORD) cloud by changing the URL to:



You can store results in IronCache with the same credentials, just set the results URL with the same syntax as the broker URL, but changing the start to ironcache:


This will default to a cache named “Celery”, if you want to change that:


More Information

You can find more information in the [iron_celery README](

Previous topic

Using Beanstalk

Next topic

First Steps with Celery

This Page