WHMCS server module for provisioning and management of VPS servers from reseller's remote WHMCS installation. Enables reseller to deploy live cloud VMs from custom VPS package configurations. Features robust end-user management interface for reseller's client to manage server from within client area of WHMCS.

• This is a Server Provisioning module for WHMCS to integrate API functionality for VPS resellers, allowing them to remotely manage Rad Web Hosting VPS Servers in remote WHMCS installation.
• Simplifies the automation of provisioning, selling, and managing VPS Servers, and provides for complete remote control of all VPS functions.

Please read the following system requirements for WHMCS VPS Reseller module:

• Working WHMCS installation (v5.3+)
• Rad Web Hosting VPS API key

Users can gain access to API key by signing up for a VPS Reseller account

1. Download the module
2. Upload to WHMCS Server Modules directory (i.e. /home/user/whmcs/modules/servers ) and extract the files
3. In WHMCS Admin area, navigate to Setup -> Products/Services -> Servers and create the rad_cloud server
4. Enter your API username and API secret. These can be obtained via your VPS Reseller Welcome Email.

Please follow the below guidelines to configure your VPS Reseller with WHMCS integration.

• WHMCS installation
• VPS Reseller account
• WHMCS server has ports 4081-4085 open

1. Download and extract the WHMCS integration [HERE].
2. Copy the entire directory via FTP, SFTP, SCP, etc. to /<WHMCS_PATH>/modules/servers/rad_cloud/

1. First, login to the VPS panel with your reseller account details.
2. Access the side menu and navigate to "API Credentials".
3. Create a API Key Pair by clicking the button.
4. API Key Pair success message will display upon successful creation.
5. Copy the API key pair credentials (these will be needed to configure WHMCS server connection).

1. From WHMCS Admin > Setup > Products/Services > Servers
2. Click "Add New Server". Follow directions:
   1. Name: Can Be Anything
   2. Hostname: The Hostname of VPS Reseller
   3. IP Address: This will be provided by the data center.
   4. Nameservers are not required for this module
3. Server Details
   1. Module: "Rad_cloud" .
   2. Username: API Key (created in previous step)
   3. Password: API Password (created in previous step)
   4. Access Hash: Leave empty

1. Navigate to Setup > Products/Services > Products/Services.
2. Select "Create a new Product"
   1. Product Type: Server/VPS
   2. Product Group: Any
   3. Product Name: Any
3. Go to "Module Settings" tab and enter the following details:
   1. Module: Rad_cloud
   2. The remaining fields as described on that page
4. Go to "Custom Fields" and create new Custom Field with the following details:
   1. Field Name: "vpsid" (without quotes)
   2. Field Type: Text Box
   3. Description: The ID of the server from VPS Panel.
   4. Validation: Leave blank
   5. Check Admin Only tick box.
5. Create "Custom Fields" entry to satisfy VPS operating system requirements:
   1. Field Name: OS or OS|Operating System
   2. Field Type: Dropdown
   3. Description: Choose OS to install on server
   4. Validation: Leave blank
   5. Select Options field: enter OS template file names (without .img extensions) like debian-12-x86_64. Retrieve possible values from: VPS Guides -> List of Available OS Templates.

• Create new VPS welcome email template. We have provided a custom email template to use for sending VPS server credentials to enduser when VPS is provisioned (created). This template will utilize merge fields and organize important server details better than the default "VPS/Dedicated Server Welcome Email" template  that is provided with WHMCS.
  • You can add the template from your WHMCS Admin area by navigating to "Setup->Email Templates"
  • Choose to "Create New Email Template"
  • Choose "Product/Service" from the "Email Type" drop-down menu and give the template a unique name
  • Configure the email sending settings
  • Add a subject for your email (i.e. "New VPS Server Details")
  • To import  our pre-made template, click "Enable/Disable Rich-Text Editor" button
  • Copy and paste the email template from below:

Dear {$client_name},

We are glad to inform you that the virtual machine you ordered has been set up.

Manager Details
=============================
URL: https://<custom_cloud_panel_domain>:4083
Username: {$service_username}
Password: {$service_password}

Server Details
=============================
Hostname: {$service_domain}
Main IP: {$service_dedicated_ip} 
Root Password: {$service_password}
{if $service_assigned_ips}
IP Address Allotted:
{$service_assigned_ips}
{/if}

You can access your server over SSH. 
If you are a Windows user, you can use a free SSH client called Putty which can be downloaded from :
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

{$signature}

• Instead of creating each VPS product with Custom Field: "OS|Operating System" and drop-down list of all available templates, we recommend creating a "Configurable Options" group with the Operating System configurable option.
• Please also refer to this article to find more information about using configurable options in WHMCS.
  • Configurable Options group can be assigned to all VPS products (of the same Virtualization)-this will be much more desirable from an administrative perspective, should the available OS templates options ever change.
  • In the event of new OS template available for VPS, you can simply modify this single Configurable Option (assuming the group is assigned to multiple VPS products for same Virtualization), as opposed to editing the custom fields drop-down values for every related VPS product individually.
• Where to get the values for available OS templates (for KVM virtualization VPS)?
• Rad Web Hosting keeps a public list of available KVM OS templates in the Knowledgebase, at: VPS Guides -> List of Available OS Templates
• Use the highlighted values (from the "Name" column) in the below image to for the Configurable Options "Operating System" drop-down values (this must be exactly the same for the automated provisioning to work):

Read our guide, How to Integrate VPS Reseller with WHMCS

For full documentation, please visit the Rad Web Hosting VPS API documentation on the website.

If you have any questions or problems please submit a Support Ticket.

If you discover any bugs or issues with this module, please notify our staff via the 24/7 Helpdesk.

This project is open-sourced software licensed under the MIT license.