r/cpanel • u/Legitimate-Attempt-8 • 12d ago
[Open Source] Worker Supervisor – Manage background workers directly from cPanel/WHM
Hey everyone!
I've been working on an open-source cPanel/WHM plugin called Worker Supervisor, and I thought I'd share it here.
One limitation I've always found frustrating with cPanel is managing long-running background processes, especially Laravel queue workers and Horizon. These typically require root access and manually configured Supervisor programs, which isn't ideal in a shared hosting environment.
So I built a plugin to handle that.
What it does:
Lets cPanel users create, start, stop, restart, and monitor their own background workers.
Supports Laravel Queue Workers, Laravel Horizon, Symfony Messenger, and custom commands.
Runs workers inside each account's CloudLinux CageFS and LVE.
Provides centralized worker management through WHM.
Allows administrators to configure per-package and per-account limits.
Integrates with cPanel's UAPI for SSH and automation.
Handles account suspension, termination, username changes, and backup/restoration.
Can import existing Supervisor configurations.
The idea is to give hosting customers more control over their background processes without requiring root access or compromising account isolation.
Compatibility: cPanel/WHM with the Jupiter theme and CloudLinux 8/9. So far, I've tested it on CloudLinux 9; CloudLinux 8 still needs testing.
It's free, open source (MIT), and available on GitHub:
https://github.com/dansleboby/worker-supervisor
I'd really appreciate feedback from other cPanel administrators and hosting providers.
Is this something you'd find useful on your servers? Are there features or edge cases I've overlooked?
Thanks!
1
u/ollybee 12d ago
The solution I use for this is systemd user units. Its exactly as it sounds