Allow your clients to create and manage servers within their limits using efficient tools for backups, snapshots, reinstallations, and real-time performance monitoring.
Use the module to Empower your customers with comprehensive control over their virtual servers.

We will guide you step by step through the whole installation and configuration process.

The content of the package to upload should look like this.

File is located in '/modules/servers/SolusVM2VpsCloud/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

This folder is available at 'your_whmcs/modules/servers/SolusVM2VpsCloud/storage'.

To do so, log in to your WHMCS and navigate to 'System Settings' →'Addon Modules'. Find 'SolusVM 2 VPS & Cloud' and press 'Activate'.

To do so, click on the 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

Afterward, press 'Add New Server'.

• Set the Module to 'SolusVM 2 VPS & Cloud For WHMCS'.
• Fill in the Secret Access Key with your SolusVM 2 API token.
  Important: Make sure the token is created for a user with the 'Admin' role. Some functions of the module might not work properly otherwise.
  

Check Secure option if your server uses an SSL connection.
You may test the connection by clicking on the dedicated button if successful, press 'Save Changes' to complete the server configuration.

Confirm by clicking on 'Save Changes'.

Afterwards, click on 'Create a New Group'.

To create a product click on 'Create a New Product'.

The App Templates section in the SolusVM 2 module allows you to import and manage operating systems and applications that can be preinstalled on a virtual machine during provisioning.
These templates are fully synchronized with your connected Solus servers.

• Navigate to the App Templates section in the addon module.
• Use the tabs at the top to switch between Operating Systems and Applications.
• Click the refresh icon to import the latest templates from your Solus instance.

Important! Before configuring a product in WHMCS, make sure you have at least one application or group of applications defined here. These templates will be used as defaults when creating virtual machines.

Navigate to 'App Templates' → 'Groups' and click on the 'Create' button.

• Name - A label for internal identification.
• Description - Optional information about the group.
• Items to include - Select which templates to bundle into this group.

When upgrading to version 1.1.0, the following changes and migrations take place automatically:

• A default group is created in the App Templates that includes all available templates.
• Existing application templates and their group associations are migrated to the new structure.
• For each product, a matching group is created and linked using the same applications and operating systems as before (e.g., product ID = 8 retains identical templates post-migration).
• Product settings are updated to use the same application group and default template as in the previous version.
• A test group is also added to demonstrate the new App Templates functionality.
  

Note: These steps ensure a seamless transition without requiring manual reconfiguration. After the upgrade, you may optionally remove any unwanted applications from the default group.

For more advanced use cases or to define your templates manually, please refer to the App Templates Advanced Configuration section in this documentation.

The module should automatically save and reload settings. If not, click on 'Save Changes' manually.

• First of all, choose the Product Type: 'VPS' or 'Cloud'.
• Next, select the desired Virtualization Type: 'KVM' or 'VZ'.

• Default User Role - new clients will be added to the SolusVM 2 panel, pick the role they will be assigned by default.
• Storage Type - select the storage type, options are defined in SolusVM 2 panel.
• Image Format - select the storage format, options are defined in SolusVM 2 panel.
  Note: Some 'Storage Type' and 'Image Format' combinations may not support certain functions (e.g., snapshots), more information can be found in the official SolusVM documentation.
• Location - select the server location, you can add more locations in the SolusVM 2 panel.
• Compute Resource - select the resource to be used, those can be prepared in the SolusVM 2 panel beforehand.
  You can also set it to 'Auto' to let SolusVM 2 decide which resource to use each time a virtual machine is created.

App Templates Configuration - To create instances based on operating systems or applications, you must first configure the App Templates in the module's addon.
Once your applications and groups are set up there, you can select the desired application in the product's Module Settings tab to be used during instance creation.
Please refer to the App Templates and App Templates Advanced Configuration sections of the documentation for detailed setup instructions.

• Default Application Group - The group of applications available for reinstalls. See the Groups section for more details.
• Default Application - The application that will be installed by default during creation. See the Applications section.

For both virtualization types, these are:

• Virtual CPUs - number of virtual CPUs assigned.
• Disk Size - disk size reserved.
  Note: Remember that there has to be at least 3GB of free space for the initial machine creation and at least 10GB for reinstallation.
• Memory - memory size of the virtual machine
• Additional IPv4 Addresses - additional ipV4 addresses to be added during creation.
• Additional IPv6 Addresses - additional ipV6 addresses to be added during creation.
• Backup Files - the maximum number of backup files, set it to '-1' to disable the limit.
• VPC Private Networks - defines the limit for VPC private network, set it to '-1' to disable the limit.
• Assigned Servers to VPC - the maximum allowed number of servers assigned to VPC, set it to '-1' to disable the limit.

Additionally, for the VZ virtualization type, define:

• vCPU Units - this argument is used in the kernel fair scheduler. The larger the number is, the more CPU time the virtual machine gets relative to other virtual machines.
• vCPU Limit - the number of CPUs the virtual machines will be limited to. Enter '0' to disable the limit.
• IO Priority - this number determines the priority of the VM's I/O requests relative to I/O requests of other virtual machines.
• SWAP - the size of the SWAP file in MiB.

• Enable IPv4 - decide if IPv4 protocol should be used.
• Enable IPv6 - decide if IPv6 protocol should be used.
• User Data - include any additional commands to be run during the first server boot.
  Note: The commands depend on the system you choose, a list of WHMCS variables that can be used with the commands has been provided as well, e.g., $email

• Generate Password - Decide if you want the service password to be generated automatically.
• Password Length - Define how long the password will be.
• Available Characters - Include characters available in the password generation process. By default, the field includes all characters permitted in SolusVM 2.
  We recommend only substracting from the default list, as adding new characters may result in validation issues.

Default Characters:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890!@#$%^&*-_

The functions that can be made available:

• Start - allows clients to power on their virtual machines.
• Stop - lets clients shut down their virtual machines.
• Restart - enables clients to reboot their virtual machines.
• Shut Down - allows clients to turn off their virtual machines completely.
• Console - provides clients with access to their virtual machine’s console interface.
• Rescue Mode - lets clients enable or disable rescue mode on their virtual machines.
• Change Password - allows clients to update the root passwords of their virtual machines.
• Log In To Panel - enables clients to access the SolusVM 2 panel.
• Backups - allows clients to create and manage backups of their virtual machines.
• Graphs - displays performance and status graphs for virtual machines.
• Network - lets clients view IP addresses, gateways, nameservers, and set primary networks.
• Reinstallation - allows clients to reinstall their virtual machines with different systems or applications.
• Snapshots - enables clients to capture snapshots of their virtual machines.
  Note: Snapshots can be taken on KVM virtualizations with LVM or ThinLVM storage types. If the image format is qcow2, File Based and NFS storage types can be used as well.
• Tasks - lets clients view the tasks performed on their virtual machines.
• Available Information - select which elements will be included in the Information section, leave blank to include all the available items.

To do so, press 'Generate' as shown on the screen below. You can choose which options to generate. Some options only work with virtual server [VZ] virtualization type.
Note: This step is optional. It is advisable not to generate options that you do not plan to use, or in case you want their fixed values to be taken from the module settings, rather than being flexible.
When you are done with the module settings, make sure to 'Save Changes'.

php -q /your_whmcs/modules/servers/SolusVM2VpsCloud/cron/cron.php queue

This cron makes sure tasks are run automatically when in the queue.
Do not forget to replace 'your_whmcs' with your WHMCS root location. The cron can be also executed every single minute in order to perform the action more often.
You will find personalized cron job information in the 'Queue' section of the addon.

You have just finished the installation and configuration of the product, congratulations!

The information displayed in the addon includes:

• Server name
• Server IP address
• Server active accounts number and limit
• Server status

This section is intended for advanced users and administrators who want to manually manage imported application and operating system templates.

To import or refresh templates in WHMCS:

• Navigate to Addon Module → App Templates.
• Use the refresh icon in the Applications or Operating Systems tab to load the latest templates from your Solus server.
  

Once imported, the templates can be grouped and assigned to specific products within WHMCS, no further manual steps are required.

Important! Only templates that already exist in Solus are supported. There is no need to create templates manually in WHMCS.

• Grouped under App Templates → Groups
• Assigned to specific WHMCS products in the product module settings.
  

No additional manual configuration is required for them to be used in provisioning.

• Click the Edit icon next to a template.
• In the Application/ Operatng System Details section, you can:
  • Update the name, description, and status
  • Upload or change a custom icon for visual presentation
• Review internal configuration values (Setting Details)

Use the Additional Actions to delete all images at once.
To upload a new image, use the 'Upload Image' button.

It allows you to view and interact with task details, including task IDs, statuses, and related items.
You can filter tasks, execute actions like deleting or running tasks, and even use mass actions for bulk operations.
For detailed guidance on using this tool, please refer to the dedicated article available here.

Prepare translations for the original English files with this handy built-in tool. For specific instructions on how to use this tool please refer to its dedicated article, you will find it here.

The action buttons include:

• Start the machine
• Stop the machine
• Shut down the machine
• Restart the machine
• Log in to SolusVM 2 panel
• Enable/Disable Rescue Mode
• Change the password of the machine
• Import From SolusVM 2.0 WHMCS Addon
  Note: Only available before a virtual machine is created in the new service, allows you to import an existing machine.

Underneath the information regarding the virtual machine is located, it includes:

• Status of the machine
• Hostname
• vCPUs in use
• Disk space allocated to the machine
• Operating system/application currently used

All tasks from the SolusVM 2 panel are logged in the 'Tasks' table. The 'Queue' table lists the tasks issued by the module.

• The Available Resources graph displays how much of the distributed resources are in use.
  
• The Virtual Machines list features details about the client's servers and offers options to:
  • Start the machine
  • Stop the machine
  • Shutdown the machine
  • Restart the machine
  • Toggle Rescue Mode on the machine
  • Open Console of the machine
  • Import existing virtual machines.
    Note: This includes an option to import instances from the SolusVM 2.0 WHMCS Addon.
    

• Task Monitoring
  • The Tasks table logs all operations executed via the SolusVM 2 panel.
  • The Queue table lists tasks issued directly by the WHMCS module and tracks their execution status.

Note: Keep in mind that the 'Suspend' module command will suspend all machines.

The basic actions include:

• Start
• Stop
• Shut Down
• Restart
• Log in To Panel
• Toggle Rescue Mode
• Change Password

If enabled, additional tools will also be available to the user.
The current information about the virtual machine is displayed in the 'Information' table.

To create a new backup use the 'Create Backup' button.
Once a backup is created, it can be deleted or used to restore the virtual machine state by clicking the action buttons next to each backup on the list.

By tracking VPS usage sudden and unexpected overloads can be avoided.

• IP Address
• Gateway
• Primary Name Server
• Secondary Name Server

and whether a given network is set as a primary for the virtual machine.

Clients can:

• Create and delete private networks.
• Attach multiple virtual machines to a private network.
• View and manage assigned private IP addresses.
  

To create a new private network, click the Add VPC Network button.

• Name – Enter a unique name for the network.
• IP Range (optional) – Define the start and end of the IP address range (From / To) that will be used within this network.
• Netmask – Specify the subnet mask for the network.

Click Confirm to finalize the configuration. If the form is filled out correctly, the new private network will appear in the list.

• The name of the virtual machine attached to the network.
• The assigned private IP address.

• Select the virtual machine to connect.
• Confirm the action to establish the internal network link.
  

Once attached, the virtual machine will be able to communicate with others in the same private network.

• Click the Detach button next to the IP address you want to remove.
• Confirm the action in the modal that appears.
  

This will disconnect the selected virtual machine from the private network.
Please note that this action is processed as a task, which means it will be placed in a queue and may take some time to complete.

Note: This action will erase all existing data and proceed with a fresh installation.

Use the 'Create Snapshot' button to take a new snapshot.
The action buttons below can be used to restore a snapshot or delete it.

The list features details such as:

• Task start time
• Task finish time
• Action
• Status
• Duration

The table features a graphical representation of the resource usage of

• vCPUs cores
• Disk limits
• Memory limits
• Additional IPv4 addresses
• Additional IPv6 addresses

Hovering over the question mark icon will display the exact numbers for each metric.

• Manage Virtual Server - opens the details page where changes can be introduced.
• Delete - starts the task of deleting the server.
• Additional Actions - allows actions such as: 'Start ', 'Stop', 'Shut Down', 'Restart', 'Toggle Rescue Mode', and 'Open Console'.

To add a new virtual machine, click on the 'Create Virtual Machine' button first.

• Hostname
• Password
• SSH Key
• vCPUs
• Disk Size
• RAM
• Primary IPv4
• Primary IPv6
• Additional IPv4
• Additional IPv6
• Image

The graph on the top of the screen can help you see how many resources remain while you allocate them to the new machine.
Click on 'Submit' when ready.

Ensure the successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.
Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.

1. Make sure all tasks are finished.
2. Optionally, back up your customized language files.
3. Delete all files from the previous version of the module.
4. Upload the new module files.
5. Migration tool should run automatically and transfer all your existing data; however, if that is not the case, please manually initiate the version upgrade with the cron command:

php -q /YOUR_WHMCS/modules/servers/SolusVM2VpsCloud/cron/cron.php module:upgrade run 1.1.0   

6. Optionally, restore changes made to the language files.

The above migration tool will transfer safely your existing applications and operating systems, automatically creating adequate groups. The same case is with configurable option osOrApplication/OS or Application that has now been replaced with app/OS or Application configurable option.

Opt for the Open Source version of your SolusVM 2 VPS & Cloud For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.

Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.