Scroll to navigation

CELERY WORKER(1) celery worker Manual CELERY WORKER(1)

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

Set custom hostname (e.g., 'w1@%%h'). Expands: %%h (hostname), %%n (name) and %%d, (domain).
Start worker as a background process.
Path to the state database. The extension '.db' may be appended to the filename.
Logging level.
Apply optimization profile.
Set custom prefetch multiplier value for this worker instance.
Number of child processes processing the queue. The default is the number of CPUs available on your system.
Pool implementation.
Send task-related events that can be captured by monitors like celery events, celerymon, and others.
Enables a hard time limit (in seconds int/float) for tasks.
Enables a soft time limit (in seconds int/float) for tasks.
Maximum number of tasks a pool worker can execute before it's terminated and replaced by a new worker.
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.
Log destination; defaults to stderr
PID file path; defaults to no PID file
Drops privileges to this user ID
Drops privileges to this group ID
Create files and directories with this umask
Override path to the Python executable
2025-03-01 5.4.0