Converter domínio adicional em conta cPanel própria
O procedimento no WHM, o que a conversão não leva junto, e o checklist que evita o site abrir com erro de banco depois da separação.

Resposta curta: use a ferramenta Convert Addon Domain to Account, em WHM >> Transfers. Arquivos, bancos e caixas de e-mail acompanham o domínio; a zona DNS é recriada e pede conferência registro a registro. Certificado SSL, usuário e senha do banco, crons, contas de FTP e caminhos absolutos precisam ser refeitos.
Neste artigo
- O que o Convert Addon Domain to Account faz e quando ele é a opção certa
- O que viaja com o domínio e o que você refaz na mão
- Por que o caminho absoluto quebra o site em silêncio
- O prefixo do banco muda junto com o usuário cPanel
- SSL, e-mail e o tamanho real da janela de indisponibilidade
- Checklist de conferência antes, depois e na entrega do painel
- Quando converter não compensa
Conta guarda-chuva é prática comum em agência: o cliente entrou como domínio adicional dentro da conta onde já rodam outros cinco sites. Funciona até o dia em que esse cliente quer cobrança separada, acesso próprio ao painel, limite de recursos próprio ou simplesmente sai da sua carteira. A partir daí, copiar pasta e exportar banco na mão é o caminho longo. O WHM tem uma ferramenta específica para isso: Convert Addon Domain to Account, em WHM >> Transfers, documentada em docs.cpanel.net.
O ponto que derruba a migração não é a ferramenta. É o que ela não leva junto e você só descobre quando o site abre com erro de conexão ao banco, ou o cron do backup para de rodar sem avisar ninguém.
O que o Convert Addon Domain to Account faz e quando ele é a opção certa
O utilitário pega um domínio adicional existente dentro de uma conta cPanel e cria uma conta cPanel nova e independente para ele, movendo (ou copiando) o conteúdo associado. A conta de origem continua existindo com os demais domínios.
Use quando:
- O cliente vai passar a ter login próprio no painel.
- Você quer quota de disco, limite de e-mail e backup separados por cliente.
- O site vai sair da sua revenda para outro provedor e você quer gerar um backup limpo de conta inteira depois da separação.
Não use quando o objetivo é só mover o site para outra pasta ou trocar o domínio principal da conta. São outras tarefas, com outras ferramentas.
A operação roda no WHM, não no cPanel do usuário, e a documentação da cPanel trata a área Transfers como funcionalidade de nível root do servidor. Antes de prometer prazo ao cliente, abra o seu WHM de revenda e verifique se o item Convert Addon Domain to Account aparece no menu Transfers. Se não aparecer, você não executa: o caminho é abrir chamado no provedor, informando a conta de origem, o domínio adicional e o nome de usuário desejado para a conta nova. O mesmo vale quando o domínio adicional está em conta de hospedagem compartilhada, sem WHM.
O que viaja com o domínio e o que você refaz na mão
A tela de conversão permite escolher o que acompanha o domínio. A lista exata de itens selecionáveis varia com a versão do cPanel & WHM, então leia a tela antes de confirmar. O racional, porém, é estável: conteúdo vinculado ao domínio viaja; configuração vinculada ao usuário antigo, ao caminho antigo ou ao servidor não viaja.
Na tabela abaixo, as linhas de arquivos, bancos de dados, contas de e-mail, encaminhadores, autorrespondedores e zona DNS seguem o que a documentação oficial descreve em docs.cpanel.net. As linhas de certificado SSL, usuário e senha do banco, tarefas cron, contas de FTP e caminho absoluto são experiência de campo: são os itens que, na prática, aparecem quebrados depois da conversão.
| Item | Comportamento esperado | O que você faz |
|---|---|---|
| Arquivos do document root | Acompanha a conversão | Conferir permissões e dono dos arquivos na conta nova |
| Bancos de dados MySQL | Acompanham quando selecionados | Validar nome do banco: o prefixo do usuário cPanel muda |
| Usuário e senha do banco | Prefixo antigo deixa de valer | Recriar usuário, dar privilégio e atualizar wp-config.php |
| Contas de e-mail e mensagens | Acompanham quando selecionadas | Reconfigurar clientes locais (senha e servidor) |
| Encaminhadores e autorrespondedores | Acompanham quando selecionados | Conferir item a item após a conversão |
| Zona DNS do domínio | Recriada para a conta nova | Comparar registro a registro com a zona antiga antes de apagar |
| Certificado SSL | Não conte com ele | Emitir de novo na conta nova e reativar o redirecionamento HTTPS |
| Tarefas cron | Ficam na conta de origem | Recriar manualmente, com o caminho absoluto novo |
| Contas de FTP | Ligadas ao usuário antigo | Recriar e entregar as credenciais novas ao cliente |
| Caminho absoluto do document root | Muda de /home/antigo/public_html/dominio para /home/novo/public_html |
Corrigir tudo que tem caminho fixo gravado |
A documentação oficial descreve o processo e as opções de cópia. Ela não substitui a conferência pós-conversão: trate a tabela acima como checklist, não como garantia.
Por que o caminho absoluto quebra o site em silêncio
Em conta guarda-chuva, o document root do domínio adicional costuma ser algo como /home/agencia/public_html/clientex. Depois da conversão vira /home/clientex/public_html. Qualquer coisa que gravou o caminho antigo para de funcionar em silêncio.
Os suspeitos de sempre, em WordPress:
- Plugin de cache (W3TC, LiteSpeed Cache, WP Rocket) com caminho de cache ou de config gravado.
- Plugin de backup com destino local.
ABSPATHcustomizado ouWP_CONTENT_DIRdefinido à mão nowp-config.php.- Upload path definido em
Configurações > Mídiaem instalações antigas. .htaccesscom regra apontando para pasta absoluta.
Varredura rápida na conta nova, por SSH:
cd ~/public_html
grep -rIl "/home/agencia/public_html" . --exclude-dir=node_modules
Se aparecer resultado, edite. Para o banco, use o WP-CLI em vez de SQL cru, que trata serialização:
wp search-replace '/home/agencia/public_html/clientex' '/home/clientex/public_html' --dry-run
Rode primeiro com --dry-run, leia a contagem de ocorrências e só então repita sem a flag.
O prefixo do banco muda junto com o usuário cPanel
No cPanel, nome de banco e nome de usuário carregam o prefixo do usuário da conta. Ao virar conta própria, o prefixo passa a ser o do novo usuário. Mesmo que o banco venha junto, o usuário antigo não tem sentido na conta nova.
Sequência que funciona:
Anotar DB_NAME, DB_USER e DB_HOST antes de converter
Abra o wp-config.php na conta de origem e guarde DB_NAME, DB_USER e DB_HOST. Isso em cada site que você for separar.
Recriar o usuário do banco na conta nova
Em cPanel >> Bancos de Dados MySQL, crie o usuário, gere senha forte e associe ao banco com ALL PRIVILEGES.
Atualizar o wp-config.php e confirmar a conexão
wp config set DB_NAME clientex_wp
wp config set DB_USER clientex_wpuser
wp config set DB_PASSWORD 'senha-gerada-no-painel'
wp db check
Os nomes acima são exemplo. Use os que o painel gerou. O wp db check retornando OK é a confirmação de que a conexão subiu.
SSL, e-mail e o tamanho real da janela de indisponibilidade
Certificado é por conta e por domínio no servidor. Depois da conversão, emita de novo na conta nova (AutoSSL ou o emissor que você usa) e só então confirme o redirecionamento para HTTPS. Se o site força HTTPS por .htaccess e o certificado ainda não foi emitido, o visitante vê aviso de site inseguro. Ordem correta: converter, emitir, testar, forçar.
E-mail é o item mais sensível porque o cliente percebe na hora. Antes de planejar a janela, separe os dois cenários.
Conversão no mesmo servidor, mesmo IP. É o caso mais comum. A zona é recriada apontando para o mesmo endereço, não há propagação envolvida e a indisponibilidade se resume aos minutos em que a conta é movida. Compare a zona nova com a antiga registro a registro e confirme que MX, SPF, DKIM e DMARC saíram iguais.
Conta nova com IP diferente ou em outra máquina. Aí existe propagação: baixe o TTL da zona para 300 segundos no dia anterior, e conte com um período em que parte dos remetentes ainda entrega no IP antigo.
Em qualquer dos dois, reduza o risco assim:
- Avise o cliente para não apagar nada do webmail durante a janela.
- Logo após a conversão, envie um e-mail de teste externo para cada caixa principal e confirme a chegada.
- Só depois reconfigure Outlook e celular do cliente, com as senhas novas quando houver.
Frase pronta para avisar o cliente da janela
Checklist de conferência antes, depois e na entrega do painel
Padronize isto em um documento e reutilize em cada separação.
Antes da conversão
- Backup completo da conta de origem, baixado para fora do servidor.
- Inventário: domínios e subdomínios do site, bancos, contas de e-mail, crons, contas de FTP, integrações externas que apontam para o domínio.
- TTL da zona reduzido, se a conta nova ficar em IP diferente ou em outra máquina.
- Janela combinada por escrito com o cliente.
Depois da conversão
- Site abre em HTTP e em HTTPS, com certificado válido.
- Login no
wp-adminfunciona e Ferramentas >> Saúde do site não acusa erro de banco. greppor caminho antigo sem resultado.- Crons recriados e com próxima execução conferida.
- Contas de FTP recriadas, credenciais antigas revogadas.
- Teste de envio e de recebimento em cada caixa.
- Registros SPF, DKIM e DMARC conferidos na zona nova.
- Backup agendado na conta nova.
- Conta de origem: remover o domínio adicional órfão e os crons que sobraram.
Entrega
- Usuário e senha do cPanel, com troca de senha obrigatória no primeiro acesso.
- Endereço do webmail e instruções IMAP.
- Quais serviços ficam com você e quais passam para o cliente.
- Data em que você apaga o backup pré-migração do seu lado.
Quando converter não compensa
Se o site tem dependência pesada de módulo específico do servidor de origem, ou se a conta nova vai para outra máquina, a conversão resolve só metade: você ainda vai gerar um backup de conta inteira e restaurá-lo no destino. Nesse cenário, avalie fazer a conversão primeiro no servidor atual, justamente para ter uma conta cPanel limpa e autossuficiente, e só então transferir. Fica mais fácil validar erro de caminho e de banco com o site ainda no servidor conhecido, antes de somar a variável do destino novo.
E se o cliente só quer nota fiscal separada, sem acesso próprio ao painel, converter pode ser trabalho sem retorno. Nesse caso, cobrança apartada resolve e você não mexe em nada que esteja funcionando.
Referências
- Documentação oficial (cpanel) — Convert Addon Domain to Account. Consultado em 2026-10-07.