How to activate a cPanel licence on your VPS

cPanel licences are tied to an IP address, not to a key you paste in. Once a licence is issued for your server's IP, the server picks it up the next time it checks in, or straight away when you run one command. This guide shows how to get the licence onto your VPS and confirm it is active.

Before you start

• cPanel & WHM installed on your VPS. See install cPanel & WHM on AlmaLinux if you have not done this yet.
• The server's public IPv4 address, from your VPS provider's control panel. Licences are issued for this exact address.
• Root SSH access to the server.

Buy the licence for the right IP

When you order, the store or partner asks for the server IP. Enter the main IPv4 address of the VPS, for example 203.0.113.10.

Points to check before you pay:

• Use the primary IP. If the VPS has several IPs, the licence must match the one the server uses for outbound connections. That is usually the first IP in your VPS provider's control panel.
• Pick the tier that fits your account count. cPanel licence tiers are based on how many cPanel accounts the server hosts. Check the vendor's current terms for what happens when you add more accounts than your tier allows.
• Keep the order confirmation. You will need it if the licence ever needs moving to a new IP.

Licences normally show as active within a few minutes of the order being processed.

Check the server time

The licence check uses secure connections, which fail if the server clock is far out. Check the time and that sync is on:

timedatectl

Look for System clock synchronized: yes. If it says no, enable time sync:

timedatectl set-ntp true

Older guides use rdate for this step. On current AlmaLinux and Ubuntu, the built-in time sync service does the same job.

Refresh the licence with cpkeyclt

Ask the server to fetch its licence now instead of waiting for the next automatic check:

/usr/local/cpanel/cpkeyclt

A successful run ends with a line like:

Updating cPanel license...Done. Update succeeded.

If the server was running a trial, this replaces the trial with the paid licence. There is no need to reinstall cPanel.

Confirm at verify.cpanel.net

Open verify.cpanel.net in your browser and enter the server IP. The page shows:

• whether a licence is active for that IP;
• the licence type and the company that issued it;
• the licence history for the IP.

If the page shows an active licence but WHM does not, the server could not reach cPanel's licence servers. See the troubleshooting section below.

Check it works

On the server, confirm the licence is valid and no warning is shown:

/usr/local/cpanel/cpkeyclt && /usr/local/cpanel/cpanel -V

Then log in to WHM at https://203.0.113.10:2087. A valid licence means no licence banner. A trial licence shows the number of days left at the top of WHM.

Troubleshooting

• "License File Expired" or "Invalid License File": the licence was issued for a different IP. Compare the IP on verify.cpanel.net with the one in your VPS provider's control panel, then ask your licence provider to move it.
• cpkeyclt cannot reach the licence server: outbound HTTPS or DNS is blocked. Check /etc/resolv.conf and make sure your firewall allows outbound TCP 80 and 443.
• Licence active on verify.cpanel.net but not on the server: the server is sending traffic from another IP. Run curl -4 https://ifconfig.co to see which IP the outside world sees.
• Still on trial after buying: the order may not have been processed yet. Wait a few minutes and run cpkeyclt again.

For a full walkthrough of licence errors, see fix cPanel licence invalid errors.

Next steps

• Using the free period first: use the cPanel 15-day trial.
• Configure the server: WHM initial setup wizard.