Transferir licença cPanel sem derrubar o site do cliente
O roteiro documental da troca, da checagem do IP de origem à revalidação no destino, com a ordem que mantém o site no ar e os prazos que a documentação oficial não define.

Resposta curta: a licença do cPanel é vinculada ao endereço IP, e a troca é feita na função Transfer a License do Manage2, informando o IP atual e o novo. A ordem segura é licença, `cpkeyclt` no destino, teste do WHM pelo IP e só então DNS.
Neste artigo
- Quem clica no botão: você ou o fornecedor da licença
- Como confirmar a qual IP a licença está presa hoje
- O formulário Transfer a License, passo a passo
- Revalidar a licença no destino com cpkeyclt e o que fazer se falhar
- Checklist de ordem: nada de DNS antes do painel abrir
- Frase pronta para avisar o cliente sem prometer duração
- Três casos em que transferir a licença é a decisão errada
- Fonte consultada e o que foi deixado de fora de propósito
Mover a licença do cPanel para o servidor novo é uma tarefa de dez minutos que vira um fim de semana perdido quando feita na ordem errada. A ordem errada é esta: apontar o DNS primeiro, descobrir depois que o WHM do destino não abre porque a licença ainda está presa no IP antigo.
A ordem certa inverte isso. Licença, validação, teste pelo IP, DNS. Nessa sequência o cliente nunca fica sem site, só sem painel, e por uma janela que você controla.
Este guia se apoia na página oficial Transfer a License da documentação do cPanel (consultada em 16/10/2026). Onde a documentação não define um valor, o texto diz que não define, em vez de inventar um.
Quem clica no botão: você ou o fornecedor da licença
Antes de abrir qualquer terminal, responda a uma pergunta administrativa: de quem é a licença.
Se você compra a licença diretamente do cPanel ou é um parceiro com acesso ao Manage2, a transferência é sua. O Manage2 é o portal onde revendedores e detentores de licença administram as licenças que possuem, e é lá que vive a função *Transfer a License*.
Se a licença veio embutida no plano do provedor de servidor (caso comum em VPS e dedicados gerenciados), você não tem acesso ao Manage2. Quem executa a transferência é o fornecedor, a pedido seu. Seu trabalho vira outro: abrir o pedido com o IP de origem e o IP de destino corretos e combinar a janela.
Nas duas situações o resto do roteiro é idêntico. Muda só quem clica.
Como confirmar a qual IP a licença está presa hoje
A licença do cPanel é vinculada a um endereço IP. Não ao hostname, não à conta, não ao hardware. Essa é a razão de a troca de servidor e a troca de IP dentro do mesmo servidor darem exatamente o mesmo trabalho.
Antes de pedir a transferência, confirme o IP de origem a partir do próprio servidor antigo, e não do que está anotado na planilha do cliente. Servidor com mais de um IP é onde o erro nasce.
# IP principal que o servidor usa para sair
curl -4 ifconfig.me
# IPs configurados nas interfaces
ip -4 addr show | grep inet
No WHM, o mesmo dado aparece no rodapé da interface e em *Server Configuration*. Anote os dois IPs, origem e destino, em um lugar só, no formato exato. Um octeto trocado no formulário de transferência gera uma licença válida apontando para uma máquina que não existe, e o diagnóstico disso custa mais que a migração inteira.
Se o servidor de destino ainda não tem IP definitivo, pare aqui. Transferir licença para IP provisório significa transferir duas vezes.
O formulário Transfer a License, passo a passo
A documentação oficial descreve a transferência como uma operação feita na interface *Transfer a License* do Manage2, onde você informa a licença atual e o novo endereço IP de destino. É um formulário, não um procedimento de linha de comando no servidor.
Buscar a licença pelo IP de origem (e por que o IP secundário não acha)
No Manage2, busque a licença pelo endereço IP atual. É por isso que a etapa anterior importa: a busca é pelo IP, e um IP secundário do servidor não encontra nada.
Preencher o IP de destino e conferir octeto por octeto
Preencha o novo IP. Revise caractere por caractere antes de confirmar. Exemplo ilustrativo, apenas para mostrar o formato esperado: origem 203.0.113.10, destino 198.51.100.25. Esses valores são de documentação, pertencem a faixas reservadas para exemplo e não devem ser usados.
Confirmar e guardar o registro da operação
Depois de confirmar, salve um print ou o identificador da operação. Em migração de cliente, o registro de quando a licença mudou de IP é o que separa "o painel caiu" de "o painel estava na janela combinada".
O que a documentação oficial do cPanel não define em número
Duas coisas que você vai querer saber e que a página oficial não estabelece como número:
- Prazo de carência no servidor antigo. Não há um intervalo documentado durante o qual a máquina de origem continua licenciada após a transferência. Planeje assumindo que o acesso ao WHM antigo pode cessar assim que a transferência é efetivada.
- Tempo de propagação da nova vinculação. A documentação não publica um tempo garantido entre confirmar a transferência e o destino passar a validar. Não prometa minutos ao cliente, porque esse número não existe em fonte oficial.
Não temos medição própria sobre nenhum dos dois. Quem afirma um valor aqui está chutando.
Revalidar a licença no destino com cpkeyclt e o que fazer se falhar
Transferida a licença, o servidor novo precisa consultar o servidor de licenciamento e atualizar o arquivo local. No destino, com acesso root:
/usr/local/cpanel/cpkeyclt
O comando força a atualização da chave. Em seguida, confirme que o WHM abre pelo IP, antes de qualquer mudança de DNS:
https://198.51.100.25:2087
(IP de exemplo, substitua pelo real.)
Se a validação falhar, a lista de causas prováveis é curta e verificável:
| Sintoma no destino | Causa provável | Verificação |
|---|---|---|
| Página de licença inválida citando o IP antigo | Transferência não concluída ou IP de origem errado no formulário | Reabrir a operação no Manage2 e conferir o IP informado |
Erro mesmo após cpkeyclt |
Servidor não alcança o serviço de licenciamento | Testar saída HTTPS do servidor para a internet |
| Licença válida, WHM não abre | Firewall bloqueando 2087 | Liberar a porta na origem do seu acesso |
| Licença aparece em IP inesperado | Servidor saindo por IP secundário ou NAT | curl -4 ifconfig.me e comparar com o IP transferido |
Só depois que o WHM do destino abre pelo IP é que a migração sai do estado reversível. Até ali, o servidor antigo ainda serve os sites e o DNS não foi tocado.
Checklist de ordem: nada de DNS antes do painel abrir
Reutilize em todo cliente. A regra é: nada de DNS enquanto o painel novo não abrir.
- Confirmar IP de origem no servidor antigo (
curl -4 ifconfig.meeip -4 addr). - Confirmar IP definitivo do destino. Se for provisório, adiar.
- Decidir quem executa: você no Manage2 ou o fornecedor por chamado.
- Combinar a janela com o cliente e enviar o aviso (frase pronta na próxima seção).
- Garantir backup e acesso root ao servidor antigo fora do painel, via SSH.
- Executar a transferência no Manage2 com os dois IPs conferidos.
- Rodar
/usr/local/cpanel/cpkeycltno destino. - Abrir o WHM do destino pelo IP, na porta 2087.
- Testar um site do destino pelo IP ou por arquivo hosts local, antes do DNS.
- Só então alterar o DNS e acompanhar a troca.
- Revisar tudo que carrega IP fixo: zonas, SPF, PTR reverso, firewalls, integrações externas e o que mais a sua lista de troca de IP cobrir.
- Arquivar o registro da transferência no histórico do cliente.
O item do backup e do acesso root por SSH é o que mais gente pula. Se a licença sair e você não tiver SSH no servidor antigo, perdeu a via de acesso para recuperar o que faltou copiar.
Frase pronta para avisar o cliente sem prometer duração
O cliente ouve "migração" e entende "site fora do ar". Nesta operação, feita na ordem acima, o site não sai. O que sai é o painel, e só para quem administra.
Frase pronta para o e-mail ou WhatsApp:
Dois cuidados na redação. Não prometa duração, porque a documentação oficial não define o tempo de propagação da nova vinculação. E não diga "sem nenhum impacto": se você precisar criar uma conta de e-mail às pressas durante a janela, vai precisar do painel, e é melhor que o cliente saiba disso antes.
Três casos em que transferir a licença é a decisão errada
Três situações em que parar e repensar sai mais barato:
- Os dois servidores vão coexistir. Se a máquina antiga continua servindo clientes durante a transição, você não transfere, você precisa de duas licenças ativas. Transferir derruba o painel de quem ficou.
- A licença é do fornecedor antigo e você está trocando de fornecedor. Não há o que transferir: a licença fica com quem a vendeu. O destino precisa de licença própria.
- Você só vai trocar o IP dentro do mesmo servidor. O procedimento é o mesmo do ponto de vista da licença, mas o resto da operação muda bastante, porque não existe servidor antigo para servir de rede de segurança.
Em qualquer um dos três, a decisão é comercial antes de ser técnica. Resolva isso com o fornecedor antes de abrir o Manage2.
Fonte consultada e o que foi deixado de fora de propósito
- cPanel, *Transfer a License*, documentação oficial do Manage2: https://docs.cpanel.net/manage2/licenses/transfer-a-license/ (consultado em 16/10/2026)
Os IPs usados ao longo do texto são de exemplo, de faixas reservadas para documentação. Os prazos não citados não foram omitidos por esquecimento: não constam da fonte oficial e não foram medidos aqui.
Referências
- Documentação oficial (cpanel) — Transfer a License. Consultado em 2026-10-16.