Long-running background processes (Supervisor)

Long-running background processes (Supervisor)

Supervisor tasks are processes meant to run continuously in the background – typically a Laravel queue worker (artisan queue:work), Laravel Horizon, the Laravel scheduler run as artisan schedule:work, or a custom Node.js/Python process. Unlike cron jobs, which run, finish and exit, a supervisor task runs continuously and the system restarts it on its own if it crashes.

Where to find them

In https://panel.cloudweb.sk, open the hosting and go to the Development tab, Supervisor Tasks sub-tab.

Creating a task

Click Add Task. Quick-start templates are available – Laravel Queue Worker, Laravel Horizon, Laravel Scheduler, Node.js Process and Python Process – which pre-fill the command and recommended settings; the command is adjusted to your hosting's application root. The form includes:

• Name – the task's identifier (letters, numbers, hyphens, underscores).
• Command – what to run, for example php /var/www/html/artisan queue:work --sleep=3 --tries=3.
• Number of processes – how many copies of the command run concurrently (1 to 10).
• Autostart – whether the task starts as soon as the hosting syncs/restarts.
• Autorestart – whether the system starts it again on its own after it crashes.
• User and, optionally, log paths (default paths are filled in automatically if left blank) and environment variables.

Controlling a task

Each task in the list offers:

• Start / Stop / Restart – immediately affects the running process on your hosting.
• View Logs – the last 100 lines of output.
• An Enable/Disable toggle – whether the task is part of the background configuration at all.
• Edit and Delete.
• Sync to Server – rewrites every task's configuration into your hosting's environment; use it if you're not sure your last change took effect.

A change (add, edit, enable/disable, delete) is synced to your hosting automatically right after saving.

Which user it runs as, and the number of processes

A task runs as the same system user as PHP-FPM and cron on that hosting: if the hosting has SSH enabled, that's the site owner; otherwise it's www-data. The "Number of processes" field can be set from 1 to 10 – a higher number means the command runs as several concurrent copies (typically several queue workers processing a queue in parallel).

Limits

The number of supervisor tasks is not capped by your plan. The command may not contain control characters or shell operators (such as a semicolon, pipe, dollar sign or parentheses) or the words eval/exec – a supervisor task is launched directly rather than through a shell, so command chaining or pipes cannot be written into this field. You can try the command by hand first in the web terminal; the steps for getting a Laravel application in place before starting a worker are in Deploying a Laravel application.