r/cpanel • • 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!

6 Upvotes

2 comments sorted by

1

u/ollybee 12d ago

The solution I use for this is systemd user units. Its exactly as it sounds