Supervisor Commands

Supervisor is a process manager that keeps Laravel queue workers and other background processes running. It automatically restarts crashed processes.

🟠 MEDIUM RISK

Restarting Supervisor will interrupt all queue workers. Pending jobs will resume after restart.

---

Table of Contents

1. Service Management
2. Process Management
3. Configuration
4. Log Management
5. Troubleshooting

---

Service Management

Check Supervisor Status

sudo systemctl status supervisor

---

Start Supervisor

sudo systemctl start supervisor

---

Stop Supervisor

🟠 QUEUE PROCESSING STOPS

Stopping Supervisor will stop all queue workers. SMS, emails, and background jobs won't process.

sudo systemctl stop supervisor

---

Restart Supervisor

sudo systemctl restart supervisor

---

Enable on Boot

sudo systemctl enable supervisor

---

Process Management

View All Processes

sudo supervisorctl status

Example Output:

laravel-worker:laravel-worker_00   RUNNING   pid 12345, uptime 2:30:45
laravel-worker:laravel-worker_01   RUNNING   pid 12346, uptime 2:30:45
horizon                            RUNNING   pid 12347, uptime 2:30:45

---

Start All Processes

sudo supervisorctl start all

Stop All Processes

🟠 QUEUE STOPS

All background processing will stop.

sudo supervisorctl stop all

Restart All Processes

sudo supervisorctl restart all

---

Manage Specific Process

# Start specific process
sudo supervisorctl start laravel-worker:*

# Stop specific process
sudo supervisorctl stop laravel-worker:*

# Restart specific process
sudo supervisorctl restart laravel-worker:*

---

Reload Configuration

# After editing config files
sudo supervisorctl reread
sudo supervisorctl update

---

Add New Process

sudo supervisorctl reread
sudo supervisorctl add process-name

Remove Process

sudo supervisorctl remove process-name

---

Configuration

Configuration Directory

ls -la /etc/supervisor/conf.d/

View Laravel Worker Config

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

Example Laravel Worker Config

[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=8
redirect_stderr=true
stdout_logfile=/var/www/html/storage/logs/worker.log
stopwaitsecs=3600

---

Key Configuration Options

Option	Description
numprocs	Number of worker processes
autostart	Start when Supervisor starts
autorestart	Restart if process dies
user	Run as this user
stopwaitsecs	Wait time before force kill
stdout_logfile	Log file location

---

After Config Changes

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl restart all

---

Log Management

View Process Logs

# Tail specific process log
sudo tail -f /var/www/html/storage/logs/worker.log

# Or use supervisorctl
sudo supervisorctl tail -f laravel-worker:laravel-worker_00

View Supervisor Main Log

sudo tail -f /var/log/supervisor/supervisord.log

Clear Worker Logs

sudo truncate -s 0 /var/www/html/storage/logs/worker.log

---

Troubleshooting

Common Issues

Process Won't Start

# Check config syntax
sudo supervisorctl reread

# Check process log
sudo supervisorctl tail laravel-worker:laravel-worker_00 stderr

# Check main log
sudo tail -50 /var/log/supervisor/supervisord.log

Process Keeps Restarting

# Check if command is correct
php /var/www/html/artisan queue:work --help

# Check permissions
ls -la /var/www/html/artisan

# Check PHP errors
sudo tail -100 /var/log/php8.3-fpm.log

"FATAL Exited too quickly"

# Process is crashing immediately
# Check the actual command manually:
cd /var/www/html
sudo -u www-data php artisan queue:work redis --tries=3

Socket Error

# Check supervisor socket
ls -la /var/run/supervisor.sock

# Restart supervisor service
sudo systemctl restart supervisor

---

Useful Commands

# Clear all process state
sudo supervisorctl clear all

# Get process info
sudo supervisorctl status laravel-worker:*

# Signal process (graceful stop)
sudo supervisorctl signal SIGTERM laravel-worker:*

---

Laravel Queue Restart

# Gracefully restart queue workers (via Laravel)
cd /var/www/html
php artisan queue:restart

# This signals workers to finish current job then restart

---

Quick Reference Card

Action	Command
Check status	sudo supervisorctl status
Start all	sudo supervisorctl start all
Stop all	sudo supervisorctl stop all
Restart all	sudo supervisorctl restart all
Reload config	sudo supervisorctl reread && sudo supervisorctl update
View logs	sudo supervisorctl tail -f process-name
Service status	sudo systemctl status supervisor
Service restart	sudo systemctl restart supervisor
Config dir	/etc/supervisor/conf.d/