Install and Configure Supervisor for Laravel Queue

| Tags: #laravel

Supervisor is a process control system for Linux that allows you to monitor and control processes on your server. It is particularly useful for managing long-running processes, such as Laravel queues, which can run for hours or even days at a time. In this post, we will go through the process of installing and using Supervisor with Laravel queue

1. Install Supervisor

The first step is to install Supervisor on your server. This can typically be done using your server’s package manager. For example, on Ubuntu, you can install Supervisor using the following command:

sudo apt-get install supervisor

Once Supervisor is installed, you can start and stop it using the following commands:

sudo systemctl start supervisor
sudo systemctl stop supervisor

2. Configure Supervisor

The next step is to configure Supervisor to manage your Laravel queue processes. Supervisor uses configuration files to define the processes it should manage. These files are typically stored in the /etc/supervisor/conf.d/ directory.

Create a new configuration file for your Laravel queue using the following command:

sudo nano /etc/supervisor/conf.d/laravel-queue.conf

In this file, you will need to define the command that Supervisor should use to start your Laravel queue. Here is an example configuration file:

command=php /path/to/artisan queue:work --queue=default --sleep=3 --tries=3 --max-time=3600

In this configuration file, we have defined a process called laravel-queue, which will run the queue:work command. We have specified that the process should start automatically and restart if it crashes, and we have set the number of processes to run to 8. We have also redirected the stderr output to a log file.

Save and close the configuration file when you are done.

3. Reload Supervisor

Once you have created your configuration file, you will need to tell Supervisor to reload its configuration:

sudo supervisorctl reread
sudo supervisorctl update

This will read your new configuration file and add the laravel-queue process to the list of processes that Supervisor should manage.

4. Start the Laravel Queue

With Supervisor configured, you can now start the Laravel queue using the following command:

sudo supervisorctl start laravel-queue:*

This will start all of the processes defined in your configuration file.

5. Monitor the Laravel Queue

This will display the status of all processes managed by Supervisor, including your Laravel queue processes.


In this post, we have gone through the process of installing and using Supervisor with Laravel queue. By using Supervisor to manage your Laravel queue processes, you can ensure that they run reliably and continuously, even if they encounter errors or crashes. This can help to ensure that your application runs smoothly and efficiently, even under heavy load.

You can read about how to create a queue in Laravel in the following article: Queues in Laravel