Skip to content

Queue Configuration

Serge Huijsen edited this page Dec 22, 2025 · 1 revision

Queue Configuration

FluxDesk uses queues for background tasks like email syncing and notifications.

Development

During development, queues run automatically with:

composer run dev

Production with Supervisor

Install Supervisor:

# Ubuntu/Debian
sudo apt-get install supervisor

# CentOS/RHEL
sudo yum install supervisor

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

[program:fluxdesk-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /path/to/fluxdesk/artisan queue:work --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=/path/to/fluxdesk/storage/logs/worker.log
stopwaitsecs=3600

Start the workers:

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

Queue Driver

By default, FluxDesk uses the database queue driver. For high-volume installations, consider Redis:

QUEUE_CONNECTION=redis

Monitoring

Check queue status:

php artisan queue:monitor

View failed jobs:

php artisan queue:failed

Retry failed jobs:

php artisan queue:retry all

Clone this wiki locally