The Laravel Artisan Cheatsheet now has an API. Learn more.


Start a new supervisor


  • balance - The balancing strategy the supervisor should apply Optional
  • delay - The number of seconds to delay failed jobs (Deprecated) Optional
  • backoff - The number of seconds to wait before retrying a job that encountered an uncaught exception Optional
  • max-jobs - The number of jobs to process before stopping a child process Optional
  • max-time - The maximum number of seconds a child process should run Optional
  • force - Force the worker to run even in maintenance mode Optional
  • max-processes - The maximum number of total workers to start Optional
  • min-processes - The minimum number of workers to assign per queue Optional
  • memory - The memory limit in megabytes Optional
  • nice - The process priority Optional
  • paused - Start the supervisor in a paused state Optional
  • queue - The names of the queues to work Optional
  • sleep - Number of seconds to sleep when no job is available Optional
  • timeout - The number of seconds a child process can run Optional
  • tries - Number of times to attempt a job before logging it failed Optional
  • auto-scaling-strategy - If supervisor should scale by jobs or time to complete Optional
  • balance-cooldown - The number of seconds to wait in between auto-scaling attempts Optional
  • balance-max-shift - The maximum number of processes to increase or decrease per one scaling Optional
  • workers-name - The name that should be assigned to the workers Optional
  • parent-id - The parent process ID Optional
  • rest - Number of seconds to rest between jobs Optional


  • name - The name of supervisor Required
  • connection - The name of the connection to work Required
php artisan horizon:supervisor [--balance [BALANCE]] [--delay [DELAY]] [--backoff [BACKOFF]] [--max-jobs [MAX-JOBS]] [--max-time [MAX-TIME]] [--force] [--max-processes [MAX-PROCESSES]] [--min-processes [MIN-PROCESSES]] [--memory [MEMORY]] [--nice [NICE]] [--paused] [--queue [QUEUE]] [--sleep [SLEEP]] [--timeout [TIMEOUT]] [--tries [TRIES]] [--auto-scaling-strategy [AUTO-SCALING-STRATEGY]] [--balance-cooldown [BALANCE-COOLDOWN]] [--balance-max-shift [BALANCE-MAX-SHIFT]] [--workers-name [WORKERS-NAME]] [--parent-id [PARENT-ID]] [--rest [REST]] [--] <name> <connection>