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

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

João Rizzon · 2026-10-08 · Painéis

---

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](https://docs.cpanel.net/whm/transfers/convert-addon-domain-to-account/).

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](https://docs.cpanel.net/whm/transfers/convert-addon-domain-to-account/). 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.
- `ABSPATH` customizado ou `WP_CONTENT_DIR` definido à mão no `wp-config.php`.
- Upload path definido em `Configurações > Mídia` em instalações antigas.
- `.htaccess` com regra apontando para pasta absoluta.

Varredura rápida na conta nova, por SSH:

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

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

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

> **** Vamos separar o seu site e os seus e-mails em uma hospedagem exclusiva, na [data], entre [hora] e [hora]. Nesse intervalo o envio e o recebimento de mensagens podem atrasar: mensagens não entregues costumam ser retentadas pelo servidor de quem enviou, e por isso pedimos que não apague e-mails pelo webmail durante a janela. Se alguma mensagem importante não chegar até [prazo], nos avise que verificamos. Depois disso, enviamos os dados novos de acesso ao painel e ajudamos a reconfigurar o seu programa de e-mail, se precisar.

## 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-admin` funciona e Ferramentas >> Saúde do site não acusa erro de banco.
- `grep` por 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.

