Licença do cPanel inválida ou expirada? Veja como conferir o status, atualizar com o cpkeyclt e resolver IP, firewall, DNS e horário do servidor.
Quando o cPanel não consegue confirmar a licença, o WHM e o cPanel passam a exibir mensagens como License File Expired, Invalid License File ou Cannot Read License File, e o acesso aos painéis fica bloqueado. Às vezes a licença realmente venceu; muitas vezes ela está ativa e o problema é o servidor não conseguir falar com os servidores de licença da cPanel.
Antes de começar
- Acesso SSH como
root. Veja como acessar o SSH do servidor. - Saber de quem é a licença: comprada direto na cPanel Store ou fornecida pelo seu provedor junto com o servidor.
Como atualizar a licença do cPanel
- Descubra com qual IP o servidor sai para a internet. A licença é vinculada a esse IP:
curl -w '\n' -s http://myip.cpanel.net/v1.0/ - Consulte o status da licença na página oficial verify.cpanel.net, informando esse IP. Se aparecer como ativa, o problema está no servidor; se aparecer vencida, suspensa ou inexistente, o problema é comercial.
- Force a atualização do arquivo de licença.
Quando tudo está certo, o comando termina em poucos segundos e não mostra mensagem de erro. Depois, recarregue o WHM no navegador./usr/local/cpanel/cpkeyclt
Se o cpkeyclt não resolver
1. A saída para a porta 2089 está bloqueada
O servidor conversa com o servidor de licenças pela porta TCP 2089 de saída. Teste:
timeout 5 bash -c 'cat < /dev/null > /dev/tcp/auth.cpanel.net/2089' && echo "2089 OK" || echo "2089 bloqueada"
Se aparecer bloqueada, libere a saída TCP 2089 no firewall do servidor (CSF, firewalld ou outro) e no firewall da rede, se houver.
2. O servidor não resolve nomes
host auth.cpanel.net
Se não houver resposta, corrija os resolvedores em /etc/resolv.conf.
3. A data e a hora do servidor estão erradas
date
timedatectl
Relógio muito atrasado ou adiantado faz a validação falhar. Ative a sincronização automática com timedatectl set-ntp true e confira com chronyc tracking (AlmaLinux) ou timedatectl timesync-status (Ubuntu).
4. O IP do servidor mudou
Se o IP do passo 1 é diferente do IP para o qual a licença foi emitida, a licença precisa ser transferida para o IP novo pela cPanel Store ou pelo provedor que a forneceu. Depois rode o cpkeyclt de novo.
5. A licença venceu
Licença de teste dura 15 dias. Licença paga vence se a fatura não foi paga. Renove na cPanel Store ou, se a licença veio com o servidor, fale com o seu provedor.
Perguntas frequentes
Os sites saem do ar quando a licença do cPanel vence?
Os serviços já em execução, como o servidor web e o de e-mail, normalmente continuam funcionando, mas o WHM e o cPanel ficam bloqueados e as atualizações param. Resolva logo, porque sem painel não dá para administrar contas.
Preciso rodar o cpkeyclt sempre?
Não. O cPanel renova a licença sozinho, de tempos em tempos. O comando manual só é útil depois de corrigir algum problema ou de transferir a licença.