The celery beat command.

See also

See preload-options and Daemon Options.


Detach and run in the background as a daemon.

-s, --schedule

Path to the schedule database. Defaults to celerybeat-schedule. The extension ‘.db’ may be appended to the filename. Default is {default}.

-S, --scheduler

Scheduler class to use. Default is {default}.


Max seconds to sleep between schedule iterations.

-f, --logfile

Path to log file. If no logfile is specified, stderr is used.

-l, --loglevel

Logging level, choose between DEBUG, INFO, WARNING, ERROR, CRITICAL, or FATAL.


File used to store the process pid. Defaults to

The program won’t start if this file already exists and the pid is still alive.


User id, or user name of the user to run as after detaching.


Group id, or group name of the main group to change to after detaching.


Effective umask (in octal) of the process after detaching. Inherits the umask of the parent process by default.


Optional directory to change to after detaching.


Executable to use for the detached process.

Module Contents


beat() Start the beat periodic task scheduler.


class beat

Start the beat periodic task scheduler.

$ celery beat -l info
$ celery beat -s /var/run/celery/beat-schedule --detach
$ celery beat -S django

The last example requires the :pypi:`django-celery-beat` extension package found on PyPI.

run(detach=False, logfile=None, pidfile=None, uid=None, gid=None, umask=None, workdir=None, **kwargs)