# 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.

> 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.

João Rizzon · 2026-10-23 · Servidores

---

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](https://docs.cpanel.net/manage2/licenses/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.

```bash
# 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:

```bash
/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.me` e `ip -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/cpkeyclt` no 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:

> **** Vamos migrar seu site para um servidor novo no dia [data], a partir das [hora]. Durante parte desse período o painel de administração do servidor pode ficar indisponível para a nossa equipe, enquanto a licença é transferida. **Seu site e seus e-mails continuam funcionando normalmente nesse intervalo.** Avisamos assim que a migração estiver concluída e validada.

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.

