An advanced WHMCS module for Pterodactyl – with live console, power management & dynamic design!
🌐 Powered by nebuliton.io – Your partner for modern hosting solutions!
- 🖥️ Live Console: Real-time terminal access via WebSockets
- ⚡ Power Actions: Start, Restart, Stop, and Kill buttons directly in WHMCS
- 📊 Resource Monitoring: Dedicated Resources tab with live CPU, Memory, Disk and Network charts
- 🎨 Dynamic Design: Automatic Light/Dark mode detection (Lagom theme supported)
- 🌍 Internationalization: Fully localized in English, German, Danish, Italian, Russian, French, Dutch
- 🗂️ Management Tabs: Manage Resources, Network (Allocations), Databases, Backups, and Startup variables
- 🛡️ Security: Built-in CSRF protection for all AJAX operations
- ⚙️ Centralized Config: Addon module for global API settings (editable directly in Addon admin page)
- 🧾 Usage Metering: Syncs Disk and Bandwidth usage into WHMCS service usage fields
- 🐦 Pterodactyl Panel v1.0.0+
- 🧩 WHMCS 8.x (recommended) or 7.x
- Upload Files:
- Move the
/pterodactyl/folder into<path to whmcs>/modules/servers/.
- Move the
- Activate Addon:
- In WHMCS navigate to System Settings -> Addon Modules (WHMCS 8+) or Setup -> Addon Modules (WHMCS 7).
- Activate Pterodactyl Addon and configure access permissions.
- Configure API Credentials:
- Go to Addons -> Pterodactyl Addon.
- Open the API Settings section in the addon admin page.
- Enter your Pterodactyl URL (e.g.,
https://panel.example.com). - Enter an Application API Key (Generated in Admin -> API with all permissions).
- Enter an Admin Client API Key (See "Client API Token" below).
- Create Server in WHMCS:
- Navigate to System Settings -> Servers.
- Create a new server, choose type Pterodactyl.
- Hostname: Your panel URL (e.g.,
panel.example.com). - Password: Your Application API Key.
- Tick Secure if using SSL.
- Create Server Group:
- Create a group and add the Pterodactyl server to it.
- Product Configuration:
- Navigate to System Settings -> Products/Services.
- Create a new product (Type: Other).
- In Module Settings, choose Pterodactyl and select your server group.
- Fill in the required fields (Nest ID, Egg ID, etc.).
The browser needs permission to connect to the Wings WebSocket from your WHMCS domain.
- Go to your Pterodactyl Panel -> Settings -> General.
- Find the Allowed Origins field.
- Add your WHMCS URL (e.g.,
https://whmcs.yourdomain.com). - Save the settings. Wings will now accept WebSocket connections from your WHMCS site.
The module uses a Client API token to fetch WebSocket authentication details.
- Log into your Pterodactyl Panel as an Administrator.
- Go to Account -> API (Top right user menu).
- Create a new API Key.
- Copy this key and paste it into the Pterodactyl Addon settings in WHMCS (Field: Admin Client API Key) or into the server's Access Hash field.
- The client area includes a Resources tab with live usage cards and history charts.
- The module implements WHMCS UsageUpdate to keep Disk/Bandwidth usage in sync with Pterodactyl resource data.
Overwriting values can be done through either Configurable Options or Custom Fields.
- You can set the API Keys also via code in the
pterodactyl.phpfile. - Their name should be exactly what you want to overwrite (e.g.,
dedicated_ip).
Valid options:
server_name, memory, swap, io, cpu, disk, nest_id, egg_id, pack_id, location_id, dedicated_ip, port_range, image, startup, databases, allocations, backups, oom_disabled, username
Environment Variables:
You can also overwrite environment variables. Use the variable name (e.g., PLAYER_SLOTS) or the friendly name.
Example: PLAYER_SLOTS|Player Slots
❌ Couldn't find any nodes satisfying the request
This can be caused by: Wrong location ID, not enough disk space/CPU/RAM on nodes, or no allocations matching the provided criteria.👤 The server gets assigned to the first/admin user
Ensure you are using the latest version of this module and that the `external_id` is correctly passed to Pterodactyl.🎨 Changing the default colors
You can change from the default whitemode to darkmode in the `clientarea.tpl` file under "pteroDefaultTheme". It detects the Lagom dark/white mode automatically.🐞 How to enable module debug log
1. Go to **System Logs -> Module Log**. 2. Click **Enable Debug Logging**. 3. Perform the action that failed. 4. Review the logs for "Pterodactyl-WHMCS" entries.- 💬 Discord Support: Join now!
- 🌐 Learn more: nebuliton.io
- Based on the original work by death-droid and Stepas
- Enhanced and modernized for Pterodactyl 1.x and Lagom theme integration
- Developed/Upgraded by the nebuliton.io Team
🚀 Ready for the future of hosting? Try nebuliton.io now! 🚀