NAME¶

celery-worker - Start worker instance.

SYNOPSIS¶

celery worker [OPTIONS]

DESCRIPTION¶

Start worker instance.

?
Examples
--------

?
$ celery --app=proj worker -l INFO
$ celery -A proj worker -l INFO -Q hipri,lopri
$ celery -A proj worker --concurrency=4
$ celery -A proj worker --concurrency=1000 -P eventlet
$ celery worker --autoscale=10,0

OPTIONS¶

-n, --hostname HOSTNAME

Set custom hostname (e.g., 'w1@%%h'). Expands: %%h (hostname), %%n (name) and %%d, (domain).

-D, --detach

Start worker as a background process.

-S, --statedb PATH

Path to the state database. The extension '.db' may be appended to the filename.

-l, --loglevel [DEBUG|INFO|WARNING|ERROR|CRITICAL|FATAL]

Logging level.

-O, --optimization [default|fair]

Apply optimization profile.

--prefetch-multiplier <prefetch multiplier>

Set custom prefetch multiplier value for this worker instance.

-c, --concurrency <concurrency>

Number of child processes processing the queue. The default is the number of CPUs available on your system.

-P, --pool [prefork|eventlet|gevent|solo|processes|threads|custom]

Pool implementation.

-E, --task-events, --events

Send task-related events that can be captured by monitors like celery events, celerymon, and others.

--time-limit FLOAT

Enables a hard time limit (in seconds int/float) for tasks.

--soft-time-limit FLOAT

Enables a soft time limit (in seconds int/float) for tasks.

--max-tasks-per-child INTEGER

Maximum number of tasks a pool worker can execute before it's terminated and replaced by a new worker.

--max-memory-per-child INTEGER

Maximum amount of resident memory, in KiB, that may be consumed by a child process before it will be replaced by a new one. If a single task causes a child process to exceed this limit, the task will be completed and the child process will be replaced afterwards. Default: no limit.

--purge, --discard

-Q, --queues COMMA SEPARATED LIST

-X, --exclude-queues COMMA SEPARATED LIST

-I, --include COMMA SEPARATED LIST

--without-gossip

--without-mingle

--without-heartbeat

--heartbeat-interval INTEGER

--autoscale <MIN WORKERS>, <MAX WORKERS>

-B, --beat

-s, --schedule-filename, --schedule TEXT

--scheduler TEXT

-f, --logfile TEXT

Log destination; defaults to stderr

--pidfile TEXT

--uid TEXT

--gid TEXT

--umask TEXT

--executable TEXT