Troubleshooting Domains

If you encounter errors or issues while working with domains, domain registration, or domain pricing and configuration, see the sections below to start troubleshooting and resolve the issue.

You can begin the troubleshooting process for most domain-related issues by reviewing recent error messages at Configuration () > System Logs.

For more information about domains in WHMCS, see Selling and Managing Domains.

Domain Configuration

For more information, see Domain Pricing.

You may encounter the following common issues:

Error or IssueExplanationNext Steps
Clicking Save Changes does not save updates to domain pricing options.The amount of data that the page is submitting exceeds the limit of the max_input_vars or post_max_size PHP configuration variables.Domain Pricing Will Not Save
Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rateThis message occurs when a currency in WHMCS is missing or does not have a properly-configured exchange rate.Unable to Display Pricing Errors

Domain Availability

For more information, see Lookup Providers and Client Area Domain Registration.

You may encounter the following common issues:

Error or IssueExplanationNext Steps
A domain search returns no results and renders a blank page.This issue is usually due to an incorrect response type.Blank Domain Search Results
Domain availability checker results are incorrect.
There was an error in your request
There was a problem connecting to the domain registry
These errors indicate a Whois-related problem or a problem with your pricing configuration.Domain Availability Errors
Domains must begin with a letter or numberThe most common cause of this issue is that you have configured WHMCS to use multiple currencies, but you have not configured a price for the currency that the client uses.Domain Availability Errors
Extension not listed in includes/whoisservers.phpThis error indicates that the domain extension in the search is not configured on your server.Domain Availability Errors
Error: 110 - Connection Error
Error: 110 - Network is unreachable
Error: 110 - Error detail unknown
This error indicates that WHMCS cannot access the Whois server in your /resources/domains/dist.whois.json file. This may be due to your firewall or another issue.Domain Availability Errors
Error: 0 - php_network_getaddresses: getaddrinfo failed: Name or service not knownThis error indicates that the domain extension does not appear in the /resources/domains/dist.whois.json file or your server is unable to resolve it.Domain Availability Errors
The domain you entered is not validThis error indicates that you have not configured pricing for the selected domain extension and WHMCS does not have a Whois server to check availability.Domain Availability Errors

Domain Registration

  • Registrar Error messages when registering, transfering, or renewing domains are from the registrar module and not WHMCS itself. To troubleshoot these errors, go to Configuration () > System Logs and check for relevant error messages.
  • After you finish resolving a domain registrar issue, you can retry the module action. For steps, see Retry a Module Action.
For more information, see Domain Registrars.

You may encounter the following common issues:

Error or IssueExplanationNext Steps
A free domain is not displaying as free in the shopping cart.In most cases, this is because the items currently in the cart do not meet the criteria for the free domain discount.Free Domain Is Not Free
A message states that the registrant’s contact details are missing, incomplete, or invalid.There is a problem in the client’s details in the Profile tab in the client’s profile.Missing Registrant Contact Errors
A message states that the admin’s contact details are missing, incomplete, or invalid.There is a problem in your contact details in the Domains tab at Configuration () > System Settings > General Settings.Missing Contact Details Errors
The Choose a Domain page is blank during the ordering process.You enabled Require Domain in the product configuration but have not enabled any domain registration options.Blank Choose a Domain Page
Automatic Domain Registration on Payment Suppressed for New Client
Automatic Domain Registration Suppressed as Domain Is Already Active
The domain is already registered, or a setting or the domain’s status is preventing WHMCS from registering it automatically.Registration Suppressed Errors
CURL Error: 56 - OpenSSL SSL_read: Success
CURL Error: 56 - OpenSSL SSL_read: error:14095126:SSL routines:ssl3_read_n:unexpected eof while reading, errno 0
These errors are due to the following system updates to EasyApache 4.OpenSSL Registrar Errors
No nameservers are defined for the server this domain is assigned toThe service’s assigned server does not have any defined nameservers.No Nameservers Are Defined Errors

Domain Renewal and Management

For more information, see Domain Renewals.

You may encounter the following common issues:

Error or IssueExplanationNext Steps
The system cancelled a domain renewal invoice unexpectedly.This issue is due to your domain redemption or domain renewal settings.Cancelled Domain Renewal Invoices
ERROR: WHMCS\Exception\InvalidDomain: The domain is invalid. in /path/to/whmcs/vendor/whmcs/whmcs-foundation/lib/Domains/Idna.php:0There is an invalid character in the tbldomains.domain field in your MySQL® database.Invalid Domain Errors
Suppressed Automatic Domain Renewal on Payment Due to Domain Being Free and having No Active Associated ProductIn many cases, this error occurs because you enabled Auto Renew Requires Product and the domain does not have an associated active product.Free Domain Did Not Renew

Last modified: June 14, 2024