How to renew cPanel License

Tags: cPanelcPanel licenseHow to

Published on: December 24, 2016 by Ankita V Kurup

How to renew cPanel License


cPanel is a licensed software and there are occasions when cPanel fails to function as expected and throws “License Invalid” error while accessing the WHM/cPanel interface. Now let see how to renew cPanel License

License Verification Process

The very first step in resolving the issue is to confirm that the license is valid

Open this link

Enter the main public IP address for a server in the text box and press “Verify License”

Now it will return whether the license is valid or not.

Even though the license is valid, cPanel may be out of sync with the licensing server and will through “License Invalid” error again. This can also happen if you had renewed the license after its expiration but the licensing server fails to update it accordingly. Here we need to refresh the licensing info with the server.

How to refresh/renew the new cPanel license

If the license is valid then log in as root to the server and run the following to refresh the license.


The normal output of the command would be something similar to this

# /usr/local/cpanel/cpkeyclt
Updating cPanel license...Done. Update succeeded.
Building global cache for cpanel...Done

If this command errors or you do not see the server contacting cPanel license servers to verify your license, please check that your server is able to contact servers via port 80 (so, check your firewall’s OUTPUT options) and that you have a proper hostname set on your server.

cPanel makes the connection to one of the cPanel licensing servers through port 2089. So we should make sure that this port is open. The best tool to check the connectivity to remote host is “Telnet”

root@server [~]# telnet 2089
Connected to (
Escape character is ‘^]’.
200 cPanel License Service Version 12.0
root@server [~]#

Sometimes on running the cpkeyclt command, you will encounter the error given below

Updating cPanel [cpkeyclt] /usr/bin/dig failed the usability test !

query failed: query timed out
info [cpkeyclt] /usr/local/cpanel/src/3rdparty/perl/perldig failed the usability test!

warn [cpkeyclt] No working dig found!
Done. Update Failed!
Error message:
License server hostnames could not be resolved to IP addresses

Building global cache for cpanel...Done

Please check your resolver file /etc/resolv.conf has working resolvers.

Your server’s main IP should not be listed as a resolver in this file nor should localhost be listed ( for the nameserver entries for the resolver.

You can also test if it was the resolver by running dig For more info about the error refer the log file /usr/local/cpanel/logs/license_log.

A successful cPanel license verification will display an output as below

Successful Licensing
[root@varuna bandwidth]# /usr/local/cpanel/cpkeyclt
Updating cPanel license…Done. Update succeeded.
Building global cache for cpanel…Done

The below given are some status codes returned when verifying license

  1. License is expired
  2. License is suspended
  3. hostname must be a FQDN
  4. Machine does not qualify for VPS license
  1. License is inactive
  2. License is invalid
  3. License version you are requesting is too old-Update cPanel
  1. The license has been activated too many times on different machines. Contact Billing for the resolution to this!

Get Dedicated Webhosting Support Team

Category : cPanel, Linux

Ankita V Kurup

Ankita V Kurup

Ankita started her career in the field of Linux System Administration since 2016. She has the ability to build productive relationships, resolve complex issues and win customer loyalty. She loves reading and travelling.

You may also read:


Add new commentSIGN IN

Let's Connect


Your Cart

Cart is empty.

Send this to a friend