Troubleshooting Licensing
If you encounter errors or issues while authenticating with WHMCS, see the sections below to start troubleshooting and resolve the issue.
- For help troubleshooting issues with the cPanel Licensing Addon, see Troubleshooting Addon Modules.
- For help troubleshooting licensing issues with hosting control panels, see Troubleshooting Server Issues.
Connection Errors
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
| You see SSL-related error messages while attempting to connect to the WHMCS licensing server. | Your server’s CA bundle files are missing or out of date. | Outdated root CA Bundles |
Curl Error: Couldn't connect to host (7)or Curl Error: Connection refused - Code 7 | This error indicates that the system cannot connect to the WHMCS licensing server. This is typically due to a firewall misconfiguration. | Couldn’t Connect Host Errors |
Curl Error - Couldn't resolve host (6) | This error indicates that DNS cannot resolve the WHMCS licensing server. This could indicate a temporary issue with your DNS provider or a misconfiguration. | Couldn’t Resolve Host Errors |
No Connection | This error indicates that there is a problem preventing your server from communicating with the WHMCS licensing server. | No Connection Errors |
Invalid License Errors
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
HostGator customers may see an Invalid License error when they try to access the Admin Area. | This is presumed due to a server migration or configuration changes. | Invalid Licenses on HostGator |
License Invalid | You entered an invalid license key or moved the WHMCS installation without updating the license. | Invalid License Errors |
Your license key is invalid on the API. | This issue occurs when you perform a required license check from a non-web context. | Invalid License API Errors |
Last modified: October 29, 2024