How to Check and Verify a cPanel License?

If you manage a VPS, cloud server, or dedicated server with cPanel & WHM, checking the license should be part of normal server maintenance. A license problem can appear after a migration, an IP change, a renewal, or a network outage. It can also explain why cPanel reports errors such as License File Expired or Cannot Read License File.

This guide explains how to check a cPanel license in two ways: through cPanel’s online verification page and from the server command line. It also covers the commands that cPanel recommends, common causes of verification failures, and the steps to take when the license is expired or cannot be reached.

Before you begin: The command-line steps require root access. Run them only on a server that you own or administer. Do not paste unknown license scripts into a terminal or share your server credentials with another person.

Why You Should Verify Your cPanel License

A cPanel license is associated with the server’s licensed IP address. If that address changes, the server may no longer match the license record. A quick verification can confirm whether the issue is the license itself or something local, such as DNS, firewall rules, or an incorrect system clock.

It is especially useful to check the license in these situations:

• After moving the server: A migration to another VPS or dedicated server often changes the public IP address.
• After changing networking: New firewall rules, DNS settings, or a hostname change can affect communication with cPanel’s licensing services.
• After renewing a license: Checking again confirms that the renewed license is visible for the correct IP.
• Before upgrading cPanel: A valid license helps prevent licensing errors during maintenance.
• When WHM features stop working: An expired or unreadable license can restrict access to parts of cPanel & WHM.
• During an outage investigation: License verification helps separate a licensing problem from a wider server or connectivity problem.

Regular checks are also useful for hosting providers that manage several servers. They make it easier to identify a license issue before it turns into a customer-facing service interruption.

Method 1: Verify a cPanel License in a Web Browser

The browser method is the simplest option when you know the server’s public IP address. It does not require SSH access, and it can be used from a separate computer.

Using the cPanel License Verification Page

1. Open the official cPanel License Verification page.
2. Enter the server’s public IP address.
3. Select Verify License.
4. Review the license information returned for that IP.

cPanel’s support documentation recommends entering the server IP on this page. If a partner provides your license, the result may identify the partner package as well as the cPanel product. The page can list licenses for different products separately, so check the cPanel entry rather than assuming that an active CloudLinux or another product license also means the cPanel license is active.

How to Find the Server IP if You Do Not Know It

From an SSH session or the Terminal in WHM, run:

curl -L https://cpanel.net/myip

The command returns the public IP address that cPanel can see. Copy that address into the verification page.

On systems where you want to compare the address used for different cPanel services, cPanel’s troubleshooting documentation also lists these commands:

curl -w ‘\n’ -s http://myip.cpanel.net/v1.0/

curl -w ‘\n’ -s http://myip.cpanel.net:2089/v1.0/

Use the result that corresponds to the server’s public licensing connection. If the addresses differ, investigate the server’s routing, NAT, or provider configuration before trying to change the license.

How to Read the Result

The exact wording can vary, but the result will normally tell you whether a current license is associated with the IP address. Treat the result as follows:

• Active: A current license is registered for the IP address.
• Expired: The license record exists, but its validity period has ended.
• No valid license: cPanel cannot find a valid license for that IP.
• Unexpected or mismatched result: The IP may be wrong, the license may be assigned to another address, or a partner may manage the license on your behalf.

If the license is active in the browser but WHM still reports an error, the problem may be local. Continue with the command-line checks below to test connectivity, DNS resolution, and the server clock.

Method 2: Check a cPanel License from the Command Line

The command-line method is useful when you already have root SSH access or when WHM is unavailable. It asks the cPanel licensing service to verify the server’s current license status.

Basic Command

Connect to the server as root:

ssh root@SERVER_IP

Replace SERVER_IP with the server’s public IP address. After logging in, run:

/usr/local/cpanel/cpkeyclt

The cpkeyclt script contacts cPanel’s licensing servers and verifies the system’s license status. cPanel’s API documentation identifies this as the command used to perform the license check.

A successful run may return no message. That behavior is documented by cPanel. If the command takes more than a few seconds, or if it returns an error, check the network and system settings described in the troubleshooting section.

Run the Command Correctly

Use the full path and run it as root:

id -u

/usr/local/cpanel/cpkeyclt

The first command should return 0, which confirms that the current shell has root privileges. Do not run the command with sudo unless your server’s sudo configuration is known and you understand how it is set up. The safest cPanel-supported approach is to log in as root or open a root shell first.

Troubleshooting cPanel License Problems

A failed verification does not always mean that the license has expired. Work through the checks below in order. Start with the IP address, then test the server’s access to cPanel’s licensing service.

Common Causes of an Invalid or Unavailable License

1. The server IP changed. The license may still be assigned to the old address.
2. The license expired or was canceled. This can happen after a failed renewal or an unpaid invoice.
3. Outbound traffic is blocked. A firewall, security group, or provider policy may prevent the server from contacting cPanel.
4. DNS resolution is failing. The server may not be able to resolve cPanel’s licensing hostname.
5. The hostname is invalid. cPanel recommends using a valid server hostname when troubleshooting license errors.
6. The system time is wrong. A clock that is far in the past or future can interfere with license validation.
7. The license belongs to another provider. A hosting company or cPanel partner may control renewal and assignment.
8. The command is being run without root access. The license refresh script requires the appropriate privileges.

1. Confirm the Licensed IP Address

First, find the IP cPanel sees:

curl -L https://cpanel.net/myip

Then enter the returned address at:

https://verify.cpanel.net/app/verify

If the address is not the one shown in your hosting panel, check whether the server is behind NAT or has multiple public interfaces. Contact the provider before moving a license to a different address.

2. Refresh the Local License Check

After confirming the IP, run:

/usr/local/cpanel/cpkeyclt

Run it once and allow it time to complete. Do not start several copies at the same time. If the command hangs or takes unusually long, move to the connectivity checks instead of repeatedly launching it.

3. Test DNS Resolution

Check whether the server can resolve cPanel’s licensing hostname:

host auth.cpanel.net

If the command returns a resolution error, inspect /etc/resolv.conf, the resolver configured by your operating system, and any provider-level DNS restrictions. cPanel specifically lists auth.cpanel.net as the hostname to check when investigating license connectivity.

4. Check the Server Date and Time

Display the current system time:

date

Compare it with the actual time and time zone. If the server clock is significantly wrong, correct the time using your operating system’s time-synchronization method, then run cpkeyclt again. cPanel includes an incorrect system date or time among the causes of license-file errors.

5. Review Firewall and Provider Rules

The server must be able to make outbound connections to cPanel’s services. Check local firewall rules, cloud security groups, and any network policy enforced by the hosting provider. If outbound HTTPS or other cPanel-required traffic is blocked, the license may appear unavailable even when it is active.

Do not open every port as a quick fix. Review the provider’s current cPanel network requirements and allow only the required outbound traffic. If you cannot change the upstream firewall, ask the hosting provider to confirm that licensing connections are permitted.

6. Contact the License Provider

If the verification page shows no valid license, or if the license is managed by your hosting company, contact the provider. Ask them to confirm:

• The license is assigned to the correct public IP.
• The license has not expired or been canceled.
• The server is using the correct cPanel product.
• The license can be transferred if the server was migrated.

If you bought the license directly from cPanel and the issue remains after the checks above, use the cPanel Store or open a cPanel support request. cPanel’s documentation directs customers to its support channels when the standard troubleshooting steps do not resolve the error.

How to Renew an Expired cPanel License

The verification page can tell you that a license is expired, but it does not renew the license. Renewal depends on who issued it.

• License purchased through the cPanel Store: Use the Store’s Manage Licenses area. cPanel states that a license that expired or was canceled less than 30 days ago can generally be reactivated by paying the existing invoice.
• License expired for more than 30 days: cPanel’s current guidance says that a new license may need to be purchased instead of paying the old invoice.
• Partner or hosting-provider license: Contact the provider that issued the license. They may need to renew it or assign it to the new IP.

After the renewal or reassignment is complete, run:

/usr/local/cpanel/cpkeyclt

Then check the IP again on the official verification page. cPanel states that the license activates when it is purchased or renewed, but the local server may still need to refresh its license information.

Understanding cPanel License Types

Your license plan determines the number of cPanel accounts supported by the license and where the license can be used. cPanel’s current pricing page lists the following plans:

• Solo: Supports one account and is available for cloud or VPS environments.
• Admin: Supports up to five accounts and is intended for smaller deployments.
• Pro: Supports up to 30 accounts and is designed for larger agencies or growing hosting operations.
• Premier: Supports up to 100 accounts, with additional-account options, and is available for VPS, cloud, and dedicated environments.

A trial or partner-provided license may appear differently from a retail plan. The verification result and the WHM Marketplace are better sources for the license actually assigned to your server than an assumption based on the number of websites hosted there.

Do not confuse the number of websites with the number of cPanel accounts. One cPanel account can host multiple websites, depending on the server configuration and cPanel features in use.

Important Command Summary

Use these commands for a normal license check:

# Find the public IP used by the server

curl -L https://cpanel.net/myip

# Refresh and verify the cPanel license as root

/usr/local/cpanel/cpkeyclt

# Test DNS resolution for cPanel licensing

host auth.cpanel.net

# Check the server date and time

date

The commands above are read-only checks or a license refresh. Avoid commands copied from forums that download and execute a script directly from the internet, especially when the source and contents are unclear.

Final Thoughts

Checking a cPanel license is straightforward when you use the official verification page and the supported cpkeyclt command. Start by confirming the server’s public IP, then verify that IP online. If the result is correct but the server still reports a problem, check DNS resolution, outbound connectivity, the hostname, and the system clock.

When a license is genuinely expired, renew it through the cPanel Store or contact the provider that issued it. After the renewal, run cpkeyclt again and repeat the browser check. Keeping these steps in your server maintenance notes can save time during migrations, renewals, and unexpected WHM errors.

Learn how to access Web Disk in cPanel with our easy step-by-step guide.