Queue Workers

XetaSuite uses Laravel queues for asynchronous tasks: sending emails, generating reports, etc.

Configuration

Recommended driver: Redis

QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379

Alternative: Database

QUEUE_CONNECTION=database

Create the jobs table:

php artisan queue:table
php artisan migrate

Start a worker

Development

php artisan queue:work

Production

Use a process manager to keep workers running.

Supervisor

Create /etc/supervisor/conf.d/xetasuite-worker.conf:

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

Enable:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start xetasuite-worker:*

Systemd

Create /etc/systemd/system/xetasuite-worker.service:

[Unit]
Description=XetaSuite Queue Worker
After=network.target

[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/xetasuite-core/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600
StandardOutput=append:/var/www/xetasuite-core/storage/logs/worker.log
StandardError=append:/var/www/xetasuite-core/storage/logs/worker-error.log

[Install]
WantedBy=multi-user.target

Enable:

sudo systemctl enable xetasuite-worker
sudo systemctl start xetasuite-worker

Laravel Forge

1. Go to Servers → your server
2. Click Queue in the menu
3. Configure:
   • Connection: redis
   • Queue: default
   • Processes: 2
4. Click Create Worker

Useful commands

Monitor workers

php artisan queue:monitor redis:default

View failed jobs

php artisan queue:failed

Retry failed jobs

# Retry all
php artisan queue:retry all

# Retry specific
php artisan queue:retry 5

Clear failed jobs

php artisan queue:flush

Restart after deployment

Caution

Workers must be restarted after code deployment to load new changes.

php artisan queue:restart

This command signals workers to gracefully restart after finishing their current job.

Horizon (Optional)

For more advanced queue management, consider using Laravel Horizon:

composer require laravel/horizon
php artisan horizon:install
php artisan migrate

Run Horizon:

php artisan horizon

Access the dashboard at /horizon.