celery(1) Celery Worker Daemon


celery [command] [-A/--app=APP] [-b/--broker=BROKER] [--loader=LOADER] [--config=CONFIG] [--workdir=WORKING_DIRECTORY] [-q/--quiet] [-C/--no-color] [--version] [--help]


This manual page documents briefly the celery command.

This manual page was written for the Debian distribution because the original program does not have a manual page.

celery is a program that manages the Celery Worker Daemons and their queues.


All inspect commands supports a --timeout argument, This is the number of seconds to wait for responses. You may have to increase this timeout if you’re not getting a response due to latency.

[shell] " 10 Drop into a Python shell. The locals will include the celery variable, which is the current app. Also all known tasks will be automatically added to locals (unless the --without-tasks flag is set). Uses Ipython, bpython, or regular python in that order if installed. You can force an implementation using --force-ipython|-I, --force-bpython|-B, or --force-python|-P.

[status] " 10 List active nodes in this cluster.

[result -t task name uuid] " 10 Show the result of a task. Note that you can omit the name of the task as long as the task doesn’t use a custom result backend.

[purge] " 10 Purge messages from all configured task queues. Warning: There is no undo for this operation, and messages will be permanently deleted!

[inspect active] " 10 List active tasks. These are all the tasks that are currently being executed.

[inspect scheduled] " 10 List scheduled ETA tasks. These are tasks reserved by the worker because they have the eta or countdown argument set.

[inspect reserved] " 10 List reserved tasks. This will list all tasks that have been prefetched by the worker, and is currently waiting to be executed (does not include tasks with an eta).

[inspect revoked] " 10 List history of revoked tasks.

[inspect registered] " 10 List registered tasks.

[inspect stats] " 10 Show worker statistics.

[control enable_events] " 10 Enable events.

[control disable_events] " 10 Disable events.

[migrate from to] " 10 Migrate tasks from one broker to another (EXPERIMENTAL). This command will migrate all the tasks on one broker to another. As this command is new and experimental you should be sure to have a backup of the data before proceeding. The value for each broker should be a URL.


This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-A APP --app=APP
App instance to use (e.g. module.attr_name).
-b BROKER --broker=BROKER
URL to the broker. Default is 'amqp://[email protected]//'.
name of custom loader class to use.
Name of the configuration module.
Optional directory to change to after detaching.
-C --no-color
Show program's version number and exit.
-h --help
Show help message and exit.


This manual page was written by fladi [email protected] for the Debian system (and may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.