Troubleshooting Licensing

If you encounter errors or issues while authenticating with WHMCS, see the sections below to start troubleshooting and resolve the issue.

Connection Errors

You may encounter the following common issues:

Error or IssueExplanationNext 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 ConnectionThis 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 IssueExplanationNext 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 InvalidYou 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: June 11, 2024