Complete Guide: Laravel Queue Setup on AWS with Supervisor & Worker Log Debugging

🚀 Laravel on AWS: Queue Job Setup with Supervisor + Debugging Guide

In this post, we’ll learn how to:

• Deploy Laravel on an AWS server
• Set up queues using Supervisor
• Configure worker.log
• Fix queue not working issues
• Debug and verify jobs

1️⃣ Laravel Project Setup on AWS EC2

sudo apt update && sudo apt upgrade -y sudo apt install php php-cli php-mbstring php-xml php-bcmath php-curl unzip curl git nginx mysql-server -y # Clone Laravel app git clone https://github.com/your/repo.git /var/www/yourapp cd /var/www/yourapp # Set permissions sudo chown -R www-data:www-data storage bootstrap/cache # Install Composer curl -sS https://getcomposer.org/installer | php php composer.phar install # Setup .env and app key cp .env.example .env php artisan key:generate

2️⃣ Nginx Configuration

# Create site config for Nginx sudo nano /etc/nginx/sites-available/yourapp # Inside config file: server { listen 80; server_name yourdomain.com; root /var/www/yourapp/public; index index.php index.html; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; } location ~ /\.ht { deny all; } } # Enable site and restart Nginx sudo ln -s /etc/nginx/sites-available/yourapp /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl restart nginx

3️⃣ Laravel Queue Setup

# Enable queue system in .env QUEUE_CONNECTION=database # Create jobs table php artisan queue:table php artisan migrate

4️⃣ Supervisor Setup for Laravel Workers

# Install Supervisor sudo apt install supervisor # Create a config file sudo nano /etc/supervisor/conf.d/laravel-worker.conf # Inside config: [program:laravel-worker] process_name=%(program_name)s_%(process_num)02d command=php /var/www/yourapp/artisan queue:work --sleep=3 --tries=3 --timeout=90 autostart=true autorestart=true user=www-data numprocs=1 redirect_stderr=true stdout_logfile=/var/www/yourapp/storage/logs/worker.log # Reload and start sudo supervisorctl reread sudo supervisorctl update sudo supervisorctl start laravel-worker:*

5️⃣ Common Issues & Fixes

Queue Not Processing?

# Check status sudo supervisorctl status # Run manually for testing php artisan queue:work # Check logs tail -f storage/logs/worker.log

Retry Failed Jobs

php artisan queue:failed php artisan queue:retry all

Permission Fix

sudo chown -R www-data:www-data storage bootstrap/cache

6️⃣ References

• Laravel Queue Docs
• Supervisor Documentation
• Laravel Queue Not Processing – Stack Overflow
• Supervisor Setup Guide – Stack Overflow

💬 Need help with Horizon, Redis queues, or Docker deployment? Drop your issue in the comments below!


Option : 2 

Path : /etc/supervisor/conf.d/laravel-worker.conf

[program:laravel-worker]

process_name=%(program_name)s_%(process_num)02d

command=php /var/www/Laravel-App/artisan queue:work --sleep=3 --tries=3 --max-time=3600

autostart=true

autorestart=true

killasgroup=true

numprocs=8

redirect_stderr=true

stdout_logfile=/var/www/Laravel-App/worker.log

stopwaitsecs=3600


Error Tips:-

You change name

dispatch(new MyJob($data))->onQueue('emails');

Then add not working, then try to add the default

OPTION : 1(defolt)
command=/usr/bin/php /var/www/casino-backend-staging/artisan queue:work --queue=dsgplay,default --sleep=20 --tries=3 --timeout=120

OPTION:2 

command=php /var/www/your-app/artisan queue:work --queue=emails --sleep=3 --tries=3 --timeout=90

🎯 Laravel Queue Worker Setup with Custom Supervisor Name

To set up Supervisor with a custom queue worker name in Laravel, follow these steps:

✅ 1. Create Supervisor Config File

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

Paste this into the file:

[program:myqueue-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/your-laravel-project/artisan queue:work --sleep=3 --tries=3 --timeout=90
autostart=true
autorestart=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/var/www/your-laravel-project/storage/logs/worker.log
stopasgroup=true
killasgroup=true

Replace /var/www/your-laravel-project with your actual path.

✅ 2. Update Supervisor

sudo supervisorctl reread
sudo supervisorctl update

✅ 3. Start the Custom Worker

sudo supervisorctl start myqueue-worker:*

✅ 4. Check Status

sudo supervisorctl status

You should see something like:

myqueue-worker_00                RUNNING   pid 12345, uptime 0:02:30

✅ 5. Laravel Queue Config

Ensure your .env file has:

QUEUE_CONNECTION=database

---

🛠️ Change Queue Name in Laravel Jobs

✅ 1. When Dispatching Job

MyJob::dispatch($data)->onQueue('emails');

// or

dispatch(new MyJob($data))->onQueue('emails');

✅ 2. Manually Update Queue Name in Database

UPDATE jobs
SET queue = 'emails'
WHERE queue = 'default';

✅ 3. Worker Should Listen to Correct Queue

php artisan queue:work --queue=emails

For Supervisor config:

command=php /var/www/your-app/artisan queue:work --queue=emails --sleep=3 --tries=3 --timeout=90

🔁 Check Existing Jobs

SELECT * FROM jobs WHERE queue = 'default';
SELECT * FROM jobs WHERE queue = 'emails';

That's it! Your Laravel queue system is now customized and production-ready.