Version Compatibility

Full Version Compatibility

• All versions of WHMCS v9.0
• All versions of WHMCS v8.13
• All versions of WHMCS v8.12
• All versions of WHMCS v8.11
• Selected versions of WHMCS v8.10
      8.10.0
• Selected versions of WHMCS v8.9
      8.9.0
• Selected versions of WHMCS v8.8
      8.8.0
• All versions of WHMCS v8.7
• All versions of WHMCS v8.6
• All versions of WHMCS v8.5
• All versions of WHMCS v8.4
• All versions of WHMCS v8.3
• All versions of WHMCS v8.2
• All versions of WHMCS v8.1
• All versions of WHMCS v8.0

System Requirements

• To work properly, the module requires a previously configured Proxmox server or Proxmox cluster (we have prepared detailed instructions)
• Available IP address range

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Developed By PUQ sp. z o.o.

Changelog

v3.0 Released April 11th, 2026

Latest Version

Version 3.0 introduces a redesigned architecture, a dedicated addon module, and a broad range of new features.

New Dedicated Addon Module

Version 3.0 includes its own dedicated addon module, reducing reliance on the previous addon structure.

• Dashboard - centralized overview of IP pools, DNS zones, and KVM services
• IP Pool Management - per-server pools, usage visibility, and improved validation
• DNS Zone Management - Cloudflare and HestiaCP integration for forward and reverse DNS
• VM Management - centralized VM overview with deploy logs, status monitoring, retry actions, and service record visibility
• Settings - separate pages for general settings and cron configuration
• Migration Support - support for importing legacy addon data during initial activation
• Access Control - configurable admin role access for the addon module

Deploy Workflow Improvements

The VM deployment process now uses a step-by-step workflow.

• Each deployment step is tracked individually
• If a step fails, the process can continue during the next cron run
• Detailed deploy logs include step timing, status changes, and error messages
• Deploy progress is visible in both CLI output and the admin area

Deploy flow:
Allocate IP -> DNS and clone -> Migrate to target node -> Set CPU and RAM -> Resize system disk -> Configure disk I/O -> Create additional disk -> Resize additional disk -> Configure additional disk I/O -> Configure network -> Configure firewall -> Configure cloud-init -> Start VM -> Verify running status and send email

Post-Clone VM Migration

Version 3.0 adds improved migration handling for cross-node deployment.

• After cloning on the template node, VMs can be migrated to the selected target node and storage
• Supports offline migration with target storage mapping
• Selects suitable target nodes based on storage availability and free RAM
• Migration timeout can be adjusted through cron configuration
• If migration is not completed, the VM can remain on the template node and deployment can continue

Change Package Workflow

Package upgrades and downgrades now use the same step-based workflow.

• Update IP and DNS
• Stop VM
• Set CPU and RAM
• Resize disks
• Configure I/O
• Configure network
• Configure firewall
• Start VM
• Verify running status

Additional improvements:

• Each step checks whether a change is required before applying it
• Detailed action logs are recorded for change operations
• If a step fails, the process can continue from the last completed step on the next cron run

Firewall Management

Version 3.0 adds expanded firewall support for deployment and client self-service.

• Deploy configuration - firewall options such as enable state, DHCP, NDP, MAC filter, IP filter, log levels, input policy, output policy, and anti-spoofing configuration can be applied during deployment
• Client area - firewall rules management with add, delete, reorder, and policy controls
• Admin product settings - dedicated Firewall configuration panel in product settings
• Rule validation - server-side validation for action, direction, protocol, IP or CIDR values, and port ranges

Cron System

The cron system supports two operating modes.

• WHMCS Hook mode - runs together with the WHMCS cron
• Standalone mode - separate cron file with CLI task controls
• Per-task intervals - each cron task can use its own interval, including the option to disable a task
• Lock management - locking support with timeout handling
• Structured results - cron tasks return structured monitoring information

Client Area Redesign

All client area pages have been updated with a redesigned interface.

• AJAX-based loading - data loads asynchronously instead of loading everything during page open
• Modern UI - consistent PUQ-style card-based layout
• Session cache - short-term VM status cache to reduce API load
• Fast polling - quicker status refresh after start and stop actions
• Firewall page - firewall rule management with reorder and policy controls
• Network information message - notification when additional IP addresses require manual configuration
• Translation support - interface text supports multilingual output

Admin Area Improvements

• Custom product settings UI - Bootstrap-based configuration panels for VM Configuration, Storage, Network, Firewall, Integrations, Email Templates, and Client Permissions
• Real-time VM information - AJAX-based status, CPU, RAM, disk, and network details
• Deploy log viewer - step-by-step deploy history with timing information
• Change package log - detailed action history with skipped-step indicators
• Quick actions - noVNC and Redeploy buttons in the admin service view
• Metric billing - bandwidth usage tracking with WHMCS Metric Billing integration

Stability Improvements

• Improved validation for addon page requests
• Improved validation for admin-side AJAX requests
• Improved validation for firewall rules, IP ranges, and port ranges
• Safer database error handling
• Cleaner DNS-related log output
• Improved compatibility for supported PHP versions

Compatibility

• WHMCS - 8.x, 9.x
• PHP - 7.4, 8.1, 8.2
• Proxmox VE - 8.x, 9.x
• ionCube Loader - v13, v14, v15

 

Previous Versions