WHMCS Module Installation and Update

Proxmox KVM module WHMCS
Order now | Download | FAQ
Download
The module is distributed as a single ZIP archive. A separate build is published for each supported PHP major version — pick the one that matches the PHP runtime used by your WHMCS installation.
All versions and historical builds are available in the index:

https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-Proxmox-KVM/

Direct "latest" downloads
PHP 8.2
wget https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-Proxmox-KVM/php82/PUQ_WHMCS-Proxmox-KVM-latest.zip

PHP 8.1
wget https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-Proxmox-KVM/php81/PUQ_WHMCS-Proxmox-KVM-latest.zip

PHP 7.4
wget https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-Proxmox-KVM/php74/PUQ_WHMCS-Proxmox-KVM-latest.zip

Not sure which PHP version your WHMCS runs on? Check Utilities > System > PHP Info in the WHMCS admin area.

Installation
Step 1: Unzip the Archive
On your WHMCS server (or locally, before uploading):
unzip PUQ_WHMCS-Proxmox-KVM-latest.zip

The archive extracts into a PUQ_WHMCS-Proxmox-KVM/ directory containing two module folders: puqProxmoxKVM (server module) and puq_proxmox_kvm (addon module).
Step 2: Copy the Server Module
Copy and replace puqProxmoxKVM from the extracted PUQ_WHMCS-Proxmox-KVM/ directory to your WHMCS installation:
PUQ_WHMCS-Proxmox-KVM/puqProxmoxKVM → WHMCS_WEB_DIR/modules/servers/puqProxmoxKVM/

Example:
cp -r PUQ_WHMCS-Proxmox-KVM/puqProxmoxKVM /var/www/html/whmcs/modules/servers/

Step 3: Copy the Addon Module
Copy and replace puq_proxmox_kvm from the extracted directory to your WHMCS installation:
PUQ_WHMCS-Proxmox-KVM/puq_proxmox_kvm → WHMCS_WEB_DIR/modules/addons/puq_proxmox_kvm/

Example:
cp -r PUQ_WHMCS-Proxmox-KVM/puq_proxmox_kvm /var/www/html/whmcs/modules/addons/

Step 4: Activate the Addon Module

Log in to the WHMCS admin area
Navigate to Setup > Addon Modules

Find PUQ Proxmox KVM in the list
Click Activate

Enter your license key
Configure access control to grant the appropriate admin roles access to the addon

Step 5: Verify Installation
After activation, navigate to Addons > PUQ Proxmox KVM in the admin menu. You should see the addon dashboard confirming a successful installation.
File Structure
After installation, the module files should be located at:
whmcs/
├── modules/
│ ├── servers/
│ │ └── puqProxmoxKVM/ # Server module
│ │ ├── puqProxmoxKVM.php
│ │ └── ...
│ └── addons/
│ └── puq_proxmox_kvm/ # Addon module
│ ├── puq_proxmox_kvm.php
│ └── ...

Update Procedure
To update the module to a newer version:

Deactivate the addon module in Setup > Addon Modules

Download the latest module archive from puqcloud.com
Upload and overwrite the server module files in modules/servers/puqProxmoxKVM/

Upload and overwrite the addon module files in modules/addons/puq_proxmox_kvm/

Reactivate the addon module in Setup > Addon Modules

Important: Database tables and all configuration data are preserved during the deactivate/reactivate cycle. Your IP pools, DNS zones, VM records, and settings will remain intact.

Tip: Always back up your WHMCS installation before performing an update.