blog
Servidores

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.

JR · · 8 min de leitura · 1 tabela · 3 blocos de código

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
  1. Quem clica no botão: você ou o fornecedor da licença
  2. Como confirmar a qual IP a licença está presa hoje
  3. O formulário Transfer a License, passo a passo
  4. Revalidar a licença no destino com cpkeyclt e o que fazer se falhar
  5. Checklist de ordem: nada de DNS antes do painel abrir
  6. Frase pronta para avisar o cliente sem prometer duração
  7. Três casos em que transferir a licença é a decisão errada
  8. 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:

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.

Ordem certa da transferência de licençaLicençaTransferir no Manage2, IPs conferidosValidaçãoRodar cpkeyclt no destinoTeste pelo IPWHM e site antes do DNSDNSSó depois do painel abrir
Ordem que mantém a migração reversível até o teste pelo IP.

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.

  1. Confirmar IP de origem no servidor antigo (curl -4 ifconfig.me e ip -4 addr).
  2. Confirmar IP definitivo do destino. Se for provisório, adiar.
  3. Decidir quem executa: você no Manage2 ou o fornecedor por chamado.
  4. Combinar a janela com o cliente e enviar o aviso (frase pronta na próxima seção).
  5. Garantir backup e acesso root ao servidor antigo fora do painel, via SSH.
  6. Executar a transferência no Manage2 com os dois IPs conferidos.
  7. Rodar /usr/local/cpanel/cpkeyclt no destino.
  8. Abrir o WHM do destino pelo IP, na porta 2087.
  9. Testar um site do destino pelo IP ou por arquivo hosts local, antes do DNS.
  10. Só então alterar o DNS e acompanhar a troca.
  11. 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.
  12. 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:

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.

Quando não transferir a licençaServidores vão coexistirPrecisa de duas licençasLicença é do fornecedor antigoDestino precisa de licença própriaTroca de IP no mesmo servidorSem rede de segurançaNenhum dos casosSiga o checklist de ordem
Pare antes de abrir o Manage2 se cair em um dos três primeiros casos.

Fonte consultada e o que foi deixado de fora de propósito

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

  1. Documentação oficial (cpanel) — Transfer a License. Consultado em 2026-10-16.
Leia também