In WHMCS, server modules allow you to quickly enable and configure automation on many popular server control panels. You can add each of your servers in order to assign sales to them and perform other important tasks.

You can access this feature at Configuration () > System Settings > Servers.

Server Groups

Server groups allow you to configure servers into sets in which you can assign products automatically, based on your requirements and provisioning settings.

For more information, see Server Groups.

Create a Server

To add a new server to your WHMCS installation:

  1. Click Add New Server.
  2. Select a server module. WHMCS ships with the following server modules by default:

  3. Provide the displayed information.
  4. Click Save Changes, or click Go to Advanced Mode to configure advanced options.

Server Settings

For each server, you can configure the following settings:

NameEnter a unique name to identify this server.
HostnameEnter the primary domain of the server. The system uses this to link to the server with certain modules.
IP AddressEnter the primary IP address of the server. The system uses this to connect to the server.
Assigned IP AddressesEnter the other IP addresses for the server here. The system uses them in conjunction with Utilities > Domain Resolver to check which domains in WHMCS are pointing to your server.
Monthly CostOptionally, enter the monthly server cost. The system uses this in reports to calculate profit.
Datacenter/NOCOptionally, enter the data center for the server. The system only uses this to help you keep records of server locations.
Maximum No. of AccountsEnter the maximum number of accounts to add to the server. The system uses this to find the server’s use percentage and determine when the default server is full. After the selected server is full, the system updates the default to provision accounts on the next server with available space.
Server Status AddressThe URL to use for status monitoring.
For more information, see Status Monitoring.
Enable/DisableCheck to disable the server.
For more information, see Enable and Disable Servers.
NameserversEnter the nameservers for this server (for example, and The system uses them in the welcome emails and when registering domains. You can specify up to five nameservers and IP addresses.
TypeThe server module.
UsernameThe username for your root or reseller account on the server.
PasswordThe password for your root or reseller account on the server.
Access HashThe access hash for your root or reseller account. Some hosting control panels require an access hash or allow you to use an access hash instead of a password.
SecureCheck to enable SSL for server connections.
PortThe port to use for connections to the server. Check Override with Custom Port to enter a custom port number.
If you do not see Port, your server module does not support port customization.
For more information, see Override with Custom Port.

Status Monitoring

Status monitoring allows you to view the load and uptime for each of your Linux®-based servers from within the WHMCS Client Area or Admin Area.

To use this feature, upload the status folder in the WHMCS ZIP file download to each of your servers. Then, enter the URL to that folder for Server Status Address. You can also leave the setting blank, which disables monitoring for that server.

WHMCS disables PHP Info output by default for security reasons. To enable it, edit the index.php file and remove the # character from (uncomment) the following line:


You can customize the monitored ports for this feature. For more information, see Customize Monitoring Ports.

Enable and Disable Servers

You can enable and disable servers. This allows you to retain server information while ensuring you do not experience issues due to intentionally-disconnected servers. The status of each server displays in the Status column in the list of servers.

  • Enabled servers display a green checkmark icon.
  • Disabled servers display a grey X icon.

Disabling a server removes it from the daily usage statistics update (which could fail if a disconnected server is enabled in WHMCS) and moves it to the bottom of all server menus.

To change the status of a server from within the list of servers, click the status icon to toggle to the other status. For example, click the green checkmark icon on an active server to deactivate it.

Override with Custom Port

Port configuration for a cPanel server

Many server modules allow you to customize the port number for connections via the server configuration. If a module supports this, Port will display in the server configuration.

If you do not see Port, your server module does not support port customization.

Check Override with Custom Port for the existing port number and then customize the port value. Unchecking Override with Custom Port will reset the value to the default for the server:

Module NameStandard PortSSL Port
Helm 48086-
For more information, see your server module’s documentation.

Default Server

If a server is the only server for the selected module, click on the name in the server list after you save the server details. Check whether an asterisk (*) appears next to it. This ensures that it is the default.

The system will use the default when any other non-specific configuration (like a server group) doesn’t apply.

Login to Control Panel

Some server modules support logging in to the control panel directly from WHMCS. To do this, click Login to Control Panel for that server.

Sync Accounts

The Sync Accounts feature can help you resolve issues in which the accounts in WHMCS do not match the accounts on your hosting server. To perform a sync, click Sync Accounts and follow the displayed instructions.

For more information about how WHMCS syncs data and steps to perform a sync, see Sync Accounts.

Delete a Server

To delete a server, click the red X icon for that server. If the deletion succeeds, a confirmation message will appear. Click OK.

You cannot delete a server with assigned accounts. This includes terminated and cancelled accounts.

Last modified: June 14, 2024