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!