Installation
This guide will walk you through installing cPanel Premium for WHMCS.
Download
After purchasing, download the cpanel_extended.zip file from your account.
Upload Files
- Extract the
cpanel_extended.zipfile - Upload the
cpanel_extendedfolder to:/path/to/whmcs/modules/servers/
Your directory structure should look like:
modules/
└── servers/
└── cpanel_extended/
├── cpanel_extended.php
├── hooks.php
├── lib/
├── ajax/
├── assets/
├── templates/
└── lang/
File Permissions
Set the correct permissions:
chmod 755 modules/servers/cpanel_extended
chmod 644 modules/servers/cpanel_extended/*.php
chmod -R 755 modules/servers/cpanel_extended/lib
chmod -R 755 modules/servers/cpanel_extended/ajax
chmod -R 755 modules/servers/cpanel_extended/assets
chmod -R 755 modules/servers/cpanel_extended/templates
Server Configuration
Add Your Server
- Go to WHMCS Admin → Setup → Products/Services → Servers
- Click Add New Server
- Fill in the details:
| Field | Value |
|---|---|
| Name | Your server name |
| Hostname | server.example.com |
| IP Address | Server IP |
| Username | root (or reseller username) |
| Password | Leave empty if using API token |
| Access Hash | WHM API token |
| Type | cPanel Premium |
| Secure | ✓ Check this box |
Generate WHM API Token
- Login to WHM as root
- Go to Development → Manage API Tokens
- Click Generate Token
- Copy the token and paste it in the Access Hash field in WHMCS
Product Configuration
Create a Product
- Go to WHMCS Admin → Setup → Products/Services → Products/Services
- Click Create a New Product
- Select:
- Product Type: Hosting Account
- Product Group: Your group
- Module: cPanel Premium
Module Settings
In the Module Settings tab, configure:
| Setting | Description |
|---|---|
| Package | cPanel package to use |
| Account Type | User or Reseller |
| Dedicated IP | Assign dedicated IP |
| CGI Access | Enable CGI scripts |
| Shell Access | Enable SSH access |
| Reseller ACL | ACL list for resellers |
| Reseller Overselling | Allow overselling |
Verification
To verify the installation:
- Go to WHMCS Admin → Utilities → Module Queue
- Check for any errors
- Create a test order and provision an account
Troubleshooting
Module Not Appearing
- Check file permissions
- Clear WHMCS cache: Utilities → System → System Cleanup
- Verify folder name is exactly
cpanel_extended
API Connection Failed
- Verify WHM API token is correct
- Check if port 2087 is open
- Ensure "Secure" checkbox is enabled
- Test API connection in WHM
Permission Denied
- Verify root/reseller has API access
- Check WHM → Security Center → Host Access Control
Need help? Contact https://vorxhub.com/workspace/tickets