Troubleshooting Server Issues
If you encounter errors or issues while working with product configuration or clients’ services, see the sections below to start troubleshooting and resolve the issue.
You can begin the troubleshooting process for most provisioning-related issues with the following steps:
- Check the Admin Dashboard for Pending Module Actions notifications:
- Review recent error messages at Utilities > Module Queue and in Module Log at Configuration () > System Logs.
- Check to ensure that the cron job’s daily automation tasks are running correctly.
- For more information, see Servers.
- For general steps to troubleshoot problems in WHMCS, see Start Troubleshooting.
General Provisioning Errors
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
406 Not Acceptable | The server’s mod_security rules blocked the query from WHMCS. | 406 Not Acceptable Errors |
| Account creation fails on the server during provisioning. | A problem prevented the system from provisioning a new account. | Account Creation Failures |
Allowed memory size of xxxxx bytes exhausted (tried to allocate xxxx bytes) | WHMCS has reached maximum amount of memory available to PHP on your server. | Allowed Memory Exhausted Errors |
Curl Error - Couldn't connect to host (7) or Server Command Error - Curl Error - Couldn't connect to host (7) or Curl Error: Connection refused - Code 7 | Your firewall is blocking a necessary port. | cURL Couldn't Connect to Host Errors |
Curl Error - Couldn't resolve host (6) or Server Command Error - Curl Error - Couldn't resolve host (6) | Your firewall is blocking a necessary port. | cURL Couldn't Resolve Host Errors |
Server Command Error - Curl Error - 28 connect() timed out or cURL error 28: Operation timed out | An operation timed out due to a connection issue. | cURL Timeout Errors |
Server Modules
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
Curl Error - Couldn't connect to host (7) or Server Command Error - Curl Error - Couldn't connect to host (7) or Curl Error: Connection refused - Code 7 | Your firewall is blocking a necessary port. | cURL Couldn't Connect to Host Errors |
Curl Error - Couldn't resolve host (6) or Server Command Error - Curl Error - Couldn't resolve host (6) | Your firewall is blocking a necessary port. | cURL Couldn't Resolve Host Errors |
Server Command Error - Curl Error - 28 connect() timed out or cURL error 28: Operation timed out | An operation timed out due to a connection issue. | cURL Timeout Errors |
No nameservers are defined for the server this domain is assigned to | The service’s assigned server does not have any defined nameservers. | No Nameservers Are Defined Errors |
Required Product Module '' Missing | The system performed a module command for a product without an assigned module. | Product Module Missing Errors |
| The uptime or CPU load statistics for a server are not displaying properly. | The server does not use a Linux®-based operating system, the status directory is inaccessible, or required PHP functions are disabled. | Status Monitoring Display Issues |
cPanel & WHM
For more information, see cPanel.
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
Access Denied/Permission Denied | The cPanel & WHM or WP Squared server denied WHMCS access to perform the requested action. | Access Denied Errors |
Action Failed Unable to auto-login. Please contact support | The username under the client’s Products/Services tab is empty. | Action Failed Errors |
Sorry, a group for that username already exists | An account with this username already exists on the server. | Group Already Exists Errors |
Invalid value paper_lantern for the cpmod setting | The product configuration in WHMCS specifies a cPanel theme that does not exist on your cPanel server. | Invalid cpmod Errors |
Key Generation Failed: (XID xxxxxx) You do not have the feature “sslmanager” | The cPanel hosting account does not have the required SSL/TLS-related permissions. | Key Generation Failed Errors |
This module requires a cPanel & WHM server with a valid license and the 'Standard' server profile. or This module requires a WP Squared server with a valid license and the 'WP Squared' server profile. | You are attempting to use a server that does not run the correct control panel or does not have a valid license. | License Profile Errors |
Login Failed | Your server configuration is incorrect or brute force protection settings are preventing access to the cPanel API. | Login Failed Errors |
No user name supplied: username is a required argument | The username under the client’s Products/Services tab is empty. | Missing Username Errors |
| The Package menu does not include all of the packages on your server. | Package use would exceed the reseller’s quotas on their WHM account. | Missing WHM Packages |
WHM Username is missing for the selected server | There is a server balancing misconfiguration. | Missing WHM Username Errors |
Registrar Error or CURL Error: 56 - OpenSSL SSL_read: Success or CURL Error: 56 - OpenSSL SSL_read: error:14095126:SSL routines:ssl3_read_n:unexpected eof while reading, errno 0 | System updates in EasyApache 4 are causing errors. | OpenSSL Registrar Errors |
Package Not Allowed or Exceeded Resource/Account Allocation | You only have reseller access to your server and are trying to create an account without a valid package name. | Package Not Allowed Errors |
You do not have permission to use Selected Package | The package name in WHMCS does not exactly match the package name in WHM. | Package Permission Errors |
Product attribute Package Name XXX not found on server | There are insufficient resources to create an account with this package, you entered the package name incorrectly, or an API token has insufficient permissions. | Product Attribute Errors |
Resellers are not permitted to create subdomains of the server's main domain | The domain is missing from the service configuration. | Reseller Subdomain Errors |
Sorry, that username is reserved | The username for the new account contains a prohibited word. | Username Reserved Errors |
Failed to load module “WpToolkitCli”: The system failed to load the module Cpanel::API::WpToolkitCli because of an error: Can't locate Cpanel/API/WpToolkitCli.pm in @INC (you may need to install the Cpanel::API::WpToolkitCli module) | The required WP Toolkit module does not exist on your cPanel & WHM server. | wptoolkitcli Errors |
Plesk
For more information, see Plesk.
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
Plesk API Response: Plesk_Manager_V163::_getSsoRedirectUrl(): Argument #2 ($username) must be of type string, null given, called in /path/to/whmcs/modules/servers.plesk/lib/Plesk/Manager/Base.php on line 0 | You have set the hosting service’s product type to Other. | _getSSORedirectUrl Errors |
| You see a blank command error. | Your firewall is blocking connections on port 8443. | Blank Command Errors |
1018 - Unable to create hosting. IP address does not exist in client's pool | There is an issue with the IP address pool configuration in Plesk. | Client Pool Errors |
2306 - Domain adding was failed. Error: xxxxx template failed: Unable to apply limits | The permissions of the domain template exceed the server resources or containing something unsupported. | Domain Setup Failures |
1013 - Error message: Customer with email '[email protected]' is not found in panel or 1013 - Error message: Customer with external id 'xxxxxxxx' is not found in panel | The product type in WHMCS is incorrect or data is missing in Plesk. | Email Not Found Errors |
1014 - Parser error: Request is invalid | A field value is missing. | Invalid Request Errors |
1023 - Unable to accept the template: the following limitations are exceeded | The subscription already used the service plan addon’s resources. | Limitations Exceeded Errors |
1014 - Parser error: Cannot parse the XML from the source specified | The client’s profile contains accents or other characters that the Plesk API does not support. | Parser Errors |
1006 - Permission denied | Your Plesk login doesn’t have the necessary permissions to use the API. | Permission Denied Errors |
503 Service Temporarily Unavailable or Page not Found or Timeout or 502 Bad Gateway | Plesk forcibly restarted Apache® when creating or suspending an account. | Plesk Connection Errors |
Plesk login requires user authentication | The user has a dynamic IP addresses or an unstable internet connection. | Plesk Login Errors |
1013 - Template does not exist | The client and domain template names are incorrect or missing. | Template Errors |
Unable to create account in Panel. The field 'username' is required. | The username under the client’s profile’s Products/Services tab is empty. | Username Required Errors |
0 - Unable to find appropriate manager for this version of Panel. Plesk should be at least 8.0 version | This is a generic error message that the Plesk module returns. | Version Errors |
The www subdomain does not function on hosting accounts on a Plesk server. | This happens due to the default DNS settings on a Plesk server. | www Does Not Work |
WP Squared
For more information, see WP Squared.
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
Access Denied/Permission Denied | The cPanel & WHM or WP Squared server denied WHMCS access to perform the requested action. | Access Denied Errors |
Action Failed Unable to auto-login. Please contact support | The username under the client’s Products/Services tab is empty. | Action Failed Errors |
This module requires a cPanel & WHM server with a valid license and the 'Standard' server profile. or This module requires a WP Squared server with a valid license and the 'WP Squared' server profile. | You are attempting to use a server that does not run the correct control panel or does not have a valid license. | License Profile Errors |
Login Failed | Your server configuration is incorrect or brute force protection settings are preventing access to the cPanel API. | Login Failed Errors |
No user name supplied: username is a required argument | The username under the client’s Products/Services tab is empty. | Missing Username Errors |
Sorry, that username is reserved | The username for the new account contains a prohibited word. | Username Reserved Errors |
Last modified: 2025 February 6