Settings
Proxmox KVM module WHMCS
Order now | Download | Community
The Settings section is divided into two pages: General and Cron.
General Settings
addon-settings-general.png
API Timeouts
| Setting | Default | Range | Description |
|---|---|---|---|
| Default Timeout | 10s | 1–300 | Timeout for Proxmox API requests from admin/client area pages |
| Heavy Operations Timeout | 60s | 1–600 | Timeout for cron operations (deploy, clone, terminate, change package) |
VM Migration
| Setting | Default | Description |
|---|---|---|
| Enable post-clone migration | Yes | When enabled, VMs cloned to the template node will be automatically migrated to the target node with the correct storage |
| Migration Timeout | 300s | Maximum wait time per cron run for migration to complete. If exceeded, cron retries on next run |
Module Data
| Setting | Default | Description |
|---|---|---|
| Delete all database tables | No | When enabled, all module database tables are dropped on addon deactivation. When disabled (default), tables are preserved for safe updates |
Cron Settings
WHMCS Hook Mode
addon-settings-cron.png
In this mode, cron tasks run automatically as part of the WHMCS system cron. No additional configuration is needed.
Standalone Mode
addon-settings-cron-standalone.png
In standalone mode, you run the cron file directly via system crontab:
* * * * * php /path/to/whmcs/modules/addons/puq_proxmox_kvm/cron.php
Cron Tasks
| Task | Default Interval | Description |
|---|---|---|
| Process Virtual Machines | 1 min | Deploys new VMs, processes change_package, refreshes DNS |
| Remove Old Snapshots | 5 min | Deletes snapshots past their configured lifetime |
| Restore Backup Status | 1 min | Checks completion of backup restore operations |
| Now Backup Status | 1 min | Checks completion of manual backup operations |
| Schedule Backup | 5 min | Runs scheduled automatic backups |
| Collecting Statistics | 60 min | Collects network usage metrics for billing |
- Set interval to 0 to disable a task
- Lock Timeout — maximum time a cron lock is held before considered stale (default: 600s)
CLI Tools
addon-cron-cli-help.png
The standalone cron file supports command-line arguments:
# Run all tasks
php cron.php
# Run specific task
php cron.php --task=processVirtualMachines
# Force run (ignore intervals)
php cron.php --force
# List tasks and their status
php cron.php --list
# Show help
php cron.php --help