Most VirtFusion servers are created automatically by WHMCS, but you will still create a VirtFusion server by hand for test machines, internal services or customers billed outside WHMCS. Creating and building are two stages: the server record is created first, then it is built with an operating system.
Before you start
- A working hypervisor with free resources and an IP block (networking and IP blocks).
- At least one package (create packages) and OS template.
- The VirtFusion user who will own the server, or details to create one.
Create the VirtFusion server
- In the admin area open Servers and choose to create a new server.
- Select the owner (user account). The server will appear in that user's control panel.
- Select the package. Its CPU, RAM, disk and traffic limits are applied.
- Select the hypervisor group or a specific hypervisor.
- Choose how many IPv4 addresses to assign and whether to assign an IPv6 subnet.
- Confirm. The server now exists but has no OS yet.
Build the server with an OS
- Open the new server and choose Build (or the build option offered after creation).
- Pick an OS template, set the hostname and choose a root password or add an SSH key.
- Start the build and watch the task progress. Template builds usually finish in a minute or two.
- When the status shows running, connect with
ssh root@SERVER_IP.
Tip: Offer SSH keys instead of passwords where you can. They are safer and the customer never receives a password by email.
Check afterwards
- The VPS answers ping and SSH on its assigned IPv4 (and IPv6 if assigned).
free -mandlsblkinside the VPS match the package.- The server shows under the correct user and the traffic graph starts filling.
Troubleshooting
- No hypervisor available: no node in the group has enough free memory, disk or IPs. Free resources or add capacity.
- Build stuck: check the hypervisor is online and the template has been downloaded to it; see common VirtFusion errors.
- No network inside the VPS: check the IP block gateway and the bridge on the hypervisor.
Frequently asked questions
Can I create a server without assigning an IP?
Yes, for private or internal machines, but the customer will need console access to reach it.
Will WHMCS know about a manually created server?
No. Link it to a WHMCS service by setting the server ID in the service's module fields if you want billing to control it.
Can I choose the exact hypervisor?
Yes, select a specific node instead of a group when you create the server.
