Skip to content

Instantly share code, notes, and snippets.

Last active January 27, 2023 21:43
What would you like to do?
Laravel Horizon, redis-server, supervisord on Ubuntu server

Laravel Horizon, redis-server, supervisord on Ubuntu 20/22 server

Laravel 8+, Horizon 5.x, Redis 6+

Parepare application

  • Install and configure Laravel Horizon as instructed in docs
  • Make sure you can access the Horizon dashboard like -
  • For now it should show status as inactive on dashbaord

Install redis-server

  • Using 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
  • Type ping and you will recieve PONG in response

  • Type exit to exit the CLI

  • Update your Laravel application .env file like this -

  • Note: you no need to touch other redis configurations, the default host and port should work fine.

  • Configure redis server

  • To make redis-server autostart upon reboot,

  • Open file with sudo nano /etc/redis/redis.conf

  • Find supervised section and update its value from no to systemd

  • Save and exit the conf file.

  • Enable the service with this command

sudo systemctl enable --now redis-server
  • We are good now.

Install supervisor

sudo apt install supervisor
sudo service supervisor restart
sudo systemctl enable supervisor

Create supervisor config 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
command=php /home/ubuntu/your-project-folder/artisan horizon
  • You need to update your-project-folder path in above config
  • Make sure your project 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, you can see status as active on dashboard.

  • Make sure to run these commands after each new deployment

php artisan horizon:terminate
php artisan horizon:purge
php artisan horizon:publish
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


Copy link

Thank you for summing it all up 💯

Copy link

In case of failed jobs, command php artisan queue:retry all not working for me, any idea?

Copy link

@usamamuneerchaudhary please post your question on Stackoverflow

Copy link

Thanks for showing every steps.

Copy link

Very Informative tnx

Copy link

This was fantastic, thanks a lot.

Copy link

Thanks man!

Copy link

It works perfectly, Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment