blog
Painéis

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.

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

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
  1. O que o Convert Addon Domain to Account faz e quando ele é a opção certa
  2. O que viaja com o domínio e o que você refaz na mão
  3. Por que o caminho absoluto quebra o site em silêncio
  4. O prefixo do banco muda junto com o usuário cPanel
  5. SSL, e-mail e o tamanho real da janela de indisponibilidade
  6. Checklist de conferência antes, depois e na entrega do painel
  7. 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:

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.

Decidir se a conversão compensaCliente quer painel próprio?Se não, cobrança apartada resolveConvert Addon aparece no WHM?Se não, abra chamado no provedorConta nova fica no mesmo servidor?Se não, baixe o TTL antesBackup da origem fora do servidorPré-requisito da janelaExecutar a conversãoWHM, Transfers
Triagem antes de marcar a janela com o cliente.

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:

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:

Frase pronta para avisar o cliente da janela

Ordem correta pós-conversãoConverterDomínio vira conta própriaRecriar bancoUsuário novo e wp-configEmitir SSLAutoSSL na conta novaTestarSite, wp-admin e caixas de e-mailForçar HTTPSSó depois do certificado válido
Inverter a ordem gera aviso de site inseguro.

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

  1. Backup completo da conta de origem, baixado para fora do servidor.
  2. 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.
  3. TTL da zona reduzido, se a conta nova ficar em IP diferente ou em outra máquina.
  4. Janela combinada por escrito com o cliente.

Depois da conversão

  1. Site abre em HTTP e em HTTPS, com certificado válido.
  2. Login no wp-admin funciona e Ferramentas >> Saúde do site não acusa erro de banco.
  3. grep por caminho antigo sem resultado.
  4. Crons recriados e com próxima execução conferida.
  5. Contas de FTP recriadas, credenciais antigas revogadas.
  6. Teste de envio e de recebimento em cada caixa.
  7. Registros SPF, DKIM e DMARC conferidos na zona nova.
  8. Backup agendado na conta nova.
  9. Conta de origem: remover o domínio adicional órfão e os crons que sobraram.

Entrega

  1. Usuário e senha do cPanel, com troca de senha obrigatória no primeiro acesso.
  2. Endereço do webmail e instruções IMAP.
  3. Quais serviços ficam com você e quais passam para o cliente.
  4. 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

  1. Documentação oficial (cpanel) — Convert Addon Domain to Account. Consultado em 2026-10-07.
Leia também