Installation

Scheduler and Queue Worker

Configure cron and systemd queue worker for Southactyl.

Scheduler and queue worker

Southactyl relies on scheduled tasks and queue workers. Skipping these is how you get a panel that looks installed but behaves broken.

Configure the scheduler

Open root's crontab:

Terminal
crontab -e

Add this line:

Cron
* * * * * php /var/www/southactyl/artisan schedule:run >> /dev/null 2>&1

Configure the queue worker

Create the service file:

Terminal
nano /etc/systemd/system/southactyl-queue.service

Paste:

/etc/systemd/system/southactyl-queue.service
[Unit]
Description=Southactyl Queue Worker
After=redis-server.service

[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/southactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target

For Rocky, AlmaLinux, or RHEL, Redis may use redis.service instead:

After=redis.service

Also change User and Group if your web server user is not www-data.

Enable the queue worker

Terminal
systemctl daemon-reload
systemctl enable --now southactyl-queue.service
systemctl status southactyl-queue.service

View queue logs

Terminal
journalctl -u southactyl-queue.service -n 100 --no-pager
Copyright © 2026