Requirements
Panel
| Component | Version |
|---|---|
| PHP | 8. or 8. (the panel runs on php:8.) |
| Laravel | 11.x (already ships with the panel) |
| Node.js | >= 22 (to build the frontend) |
| Yarn | any recent version |
| MySQL / MariaDB | whatever the panel already uses |
| PHP extensions | json, mbstring, pdo, pdo_, posix, zip (already included with the panel) |
| Queue worker | required: jobs run through queue:work; without a worker, domains stay pending forever |
The addon doesn't introduce PHP syntax that requires a version newer than what the panel already needs (it uses constructor property promotion from PHP 8.0+, nothing PHP 8.3-only). If the panel starts, the addon runs with no extra language requirements.
Node (Wings)
| Component | Detail |
|---|---|
| Go | 1. (toolchain 1.), only if you're compiling Wings yourself |
| nginx | installed and running, with the ability to reload (nginx -) |
| certbot | apt install certbot python3-, only if you plan to allow Let's Encrypt on some node |
| Port 80 | open and reachable from the internet, a certbot requirement (HTTP-01 challenge) |
| Wings permissions | must be able to write to / and /, and run nginx / certbot without a password prompt |
Quick checklist before installing
- The panel already runs on PHP 8.2 or 8.3
- A
queue:workis running in the background (supervisor or systemd) yarnand Node ≥22 available to rebuild the frontend- nginx installed on every node where the addon will be used
- Port 80 open on those nodes (if you're going to offer Let's Encrypt)
certbotinstalled on those nodes (if you're going to offer Let's Encrypt)
Next: Installation: Panel →

