Proxmox Module Initial Installation Guide

1. Upload both modules/servers/proxmoxModule/ and modules/addons/proxmoxModule/ from package.
2. Activate proxmoxModule addon from WHMCS Addon Modules.
3. Enter and save licenseKey.

1. Go to WHMCS System Settings > Servers.
2. Add server and select module proxmoxModule.
3. Enter host, username, password, realm, and port.
4. Validate connection with Test Connection.

1. Add IPs from module IP management or enable integration if IPManager exists.
2. Verify dedicated/assigned IP data on services.
3. Test IP assignment during provisioning.

1. Add product config option in format operatingsystem|xxx.
2. Each option must follow vmTemplateName|OS Name.
3. Example: tpl-ubuntu-22|Ubuntu 22.04, tpl-win-2022|Windows Server 2022.

1. Create VMID and Node custom fields on product.
2. Ensure names match module configuration mapping.
3. Validate VMID/Node handling on test service.

1. Create a configuration in addon panel Configs section first.
2. Define limits and VM behavior in this config.
3. Open Products page and assign that config to the product.
4. Run a test provision flow after saving mapping.

• Windows template: Installing QEMU Agent is sufficient.
• Linux template: After QEMU Agent, run:

apt update
apt install cloud-init -y
rm -f /etc/cloud/cloud-init.disabled

nano /etc/cloud/cloud.cfg.d/99_pve.cfg
# write:
datasource_list: [ NoCloud, ConfigDrive ]

chown root:root /etc/cloud/cloud.cfg.d/*
chmod 644 /etc/cloud/cloud.cfg.d/*

systemctl enable cloud-init
systemctl enable cloud-config
systemctl enable cloud-final

truncate -s 0 /etc/machine-id
rm -f /var/lib/dbus/machine-id
ln -s /etc/machine-id /var/lib/dbus/machine-id

cloud-init clean

After these steps, add Cloud-Init Drive from Proxmox and convert VM to template.