Assuming you are on Ubuntu 22/24 and a Laravel php v10/11 application.
Prepare your Laravel app
- Install and configure Laravel Horizon as instructed in docs
- Make sure you can access the Horizon dashboard like - *
http://yourapp.com/horizon - For now; it should show status as inactive on horizon dashboard
Install redis-server (unless you already have it)
We will be using a PPA for latest version
sudo add-apt-repository -y ppa:redislabs/redis
sudo apt-get update
sudo apt-get install -y redis-server
Test if redis-server is working, run
redis-cli
Type ping and hit enter and you will receive PONG in response
Type exit and hit enter to exit from the CLI
Update your Laravel application .env file like this -
QUEUE_CONNECTION=redis
Configure redis server
To make redis-server auto start upon machine reboot,
Edit this file with sudo nano /etc/redis/redis.conf.
Find supervised section and update its value from auto to systemd
Save and exit the conf file.
Now enable the service with this command:
sudo systemctl enable --now redis-server
We are good now with redis server.
Install supervisor
sudo apt install supervisor
sudo service supervisor restart
sudo systemctl enable supervisor
Create supervisor config file for Horizon.
Supervisor keeps its programs' individual files in /etc/supervisor/conf.d
Create a fresh config file for your Laravel application
sudo nano /etc/supervisor/conf.d/laravel-app.conf
and paste these lines into nano editor
program:laravel_horizon]
process_name=%(program_name)s_%(process_num)02d
command=php /home/ubuntu/your-project-folder/artisan horizon
autostart=true
autorestart=true
redirect_stderr=true
user=www-data
stdout_logfile=/home/ubuntu/your-project-folder/storage/horizon.log
stdout_logfile_maxbytes=10MB
logfile_backups=14
stopwaitsecs=3600
You need to update your-project-folder path in file above
Make sure your project's storage folder is writable by www-data (apache) user (same as your web server user).
Save the config file and exit nano.
Now run these commands one by one -
sudo supervisorctl reread
sudo supervisorctl update
Check if our horizon process is running
sudo supervisorctl
You will see process name with status RUNNING, if not; it means you have misconfigured something.
Access your horizon dashboard at http://yourapp.com/horizon, you can see status as active on dashboard.
You can also check horizon status with command
php artisan horizon:status
Make sure to run these commands after each new deployment
php artisan horizon:terminate
php artisan horizon:purge
php artisan queue:restart
If you face any issue, you can restart supervisor service
sudo service supervisor restart
OR - You can restart specific program
sudo supervisorctl restart laravel_horizon
Similar resources
- https://serversforhackers.com/c/monitoring-processes-with-supervisord
- https://www.digitalocean.com/community/tutorials/how-to-install-and-secure-redis-on-ubuntu-18-04
Support if you found this helpful😉
No Money 🙅🏻♀️ just Subscribe to my YouTube channel.
Linktree Profile: https://linktr.ee/DevOps_Descent
GitHub: https://github.com/devopsdescent
Top comments (0)