Supervisor Setup Guide for Laravel Horizon

Laravel Horizon manages your background jobs (queues). To keep Horizon running continuously — even after a reboot — we'll use Supervisor, a lightweight Linux process manager.

Prerequisites

Before proceeding with this setup, ensure you meet the following requirements:

HOSTING REQUIREMENTS

❌ This feature is NOT available on shared hosting You must have a Cloud Server or VPS with root access to configure Supervisor.

System Requirements

• Server Type: Cloud Server, VPS, or Dedicated Server
• Access Level: Root/Administrator access required
• SSH Access: Command line access to your server

Software Requirements

• Redis: Must be installed and working properly
  • Test with: redis-cli ping (should return "PONG")
  • If Redis is not installed: Follow the Redis installation guide for Linux
  • CloudPanel.io users: Redis is already pre-installed if you're using CloudPanel.io
• WhatsMark SaaS: Version 1.4.2 or greater
• Laravel Horizon: Already configured and installed in WhatsMark SaaS version 1.5.0+

Verification Steps

Before starting, verify your setup:

1. Check WhatsMark SaaS version in your admin dashboard
2. Test Redis connection: Run redis-cli ping in terminal
3. Confirm root access: Run sudo whoami (should return "root")
4. Verify Laravel Horizon: Check if php artisan horizon command exists

💡 COMPATIBILITY NOTE

If you're using an older version of WhatsMark SaaS, please upgrade to version 1.4.2+ before proceeding with this configuration.

---

Important Disclaimer

TECHNICAL EXPERTISE REQUIRED

⚠️ This setup requires technical knowledge of server configuration and Linux commands. If you are not confident with terminal commands, SSH access, or process management — please do not attempt this yourself.

You can hire a qualified server administrator or contact our support team for professional setup assistance. Our experts can handle the entire configuration for you safely and efficiently.

💡 PERFORMANCE RECOMMENDATION

We highly recommend enabling this advanced configuration if you want your campaigns to run faster and improve the overall performance and reliability of your Laravel application.

---

Step 1: Install Supervisor

Run the following commands on your Ubuntu/Debian server:

sudo apt update
sudo apt install supervisor -y

Check that Supervisor is active:

sudo systemctl status supervisor

You should see:

Active: active (running)

---

Step 2: Create Horizon Configuration

Create a new Supervisor configuration file:

sudo nano /etc/supervisor/conf.d/horizon.conf

Paste this optimized configuration:

; WhatsApp SaaS - Laravel Horizon Supervisor Configuration
; Copy this file to /etc/supervisor/conf.d/whatsmarksaas-horizon.conf
; Replace {{PROJECT_PATH}} with your actual project path
; Replace {{WEB_USER}} with your web server user (www-data, nginx, apache, etc.)

[program:whatsmarksaas-horizon]
process_name=%(program_name)s_%(process_num)02d
command=php /home/corbitaltech-passthecode/htdocs/whatsmarksaas.dev/artisan horizon
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=corbitaltech-whatsmarksaas
numprocs=1
redirect_stderr=true
stdout_logfile=/dev/null
stderr_logfile=/dev/null
stopwaitsecs=3600
environment=LARAVEL_ENV="production"

; Example with actual paths:
; Replace {{PROJECT_PATH}} with: /var/www/html/whatsmarksaas-saas
; Replace {{WEB_USER}} with: www-data

; After creating this file:
; sudo supervisorctl reread
; sudo supervisorctl update
; sudo supervisorctl start whatsmarksaas-horizon:*

Save and exit:Ctrl + O → Enter → Ctrl + X

---

Step 3: Reload and Start Supervisor

Reload configuration and start Horizon:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start laravel-horizon

Check status:

sudo supervisorctl status

You should see:

laravel-horizon        RUNNING   pid 1234, uptime 0:02:10

---

Step 4: (Optional) Specific Queue Configuration

If you want Horizon to handle a specific queue (for example: a high priority queue), you can modify your configuration:

[program:laravel-horizon-high]
command=php /path-to-your-project/artisan horizon --queue=high
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/dev/null

💡 QUEUE CONFIGURATION

This example shows how to configure Horizon to process jobs from a specific queue named "high". You can replace "high" with any queue name that matches your application's needs.

---

Step 5: Useful Commands

Command	Description
sudo supervisorctl status	Show running programs
sudo supervisorctl start laravel-horizon	Start Horizon
sudo supervisorctl stop laravel-horizon	Stop Horizon
sudo supervisorctl restart laravel-horizon	Restart Horizon
sudo systemctl restart supervisor	Restart Supervisor service

---

Step 6: Auto-Start on Reboot

Enable Supervisor to start automatically:

sudo systemctl enable supervisor

After this, Horizon will automatically run whenever the server restarts.

---

Summary

• Supervisor keeps Laravel Horizon running 24/7
• Campaigns process faster and queues become more reliable
• Logs are disabled for cleaner operation
• Recommended for production servers to improve performance

---

Final Recommendation

This is an advanced configuration designed for better performance and scalability. Incorrect setup can break background jobs or cause server instability.

⚠️ NEED HELP WITH SETUP?

If you're unsure about any step:

💬 Contact our support team for paid setup assistance.

Or hire a technical expert to configure Supervisor for you.

🚀 PROFESSIONAL OPTIMIZATION

Our team can handle complete server optimization — ensuring faster campaign execution, stable queues, and maximum Laravel performance.