# Migrar e-mails de domínio adicional do cPanel em 7 passos

O domínio adicional virou conta própria, o site subiu e as caixas apareceram vazias. O processo de cópia IMAP a IMAP, com a conferência que você faz antes de apagar a origem.

> os e-mails de um domínio adicional não migram junto com os arquivos: eles pertencem à conta cPanel principal e precisam ser copiados caixa a caixa por IMAP, em 7 passos, com conferência pasta por pasta antes de remover o domínio da conta antiga.

João Rizzon · 2026-09-21 · Painéis

---

## Por que as caixas do domínio adicional não viajam com os arquivos

Quando você tira um domínio adicional de uma conta cPanel e cria uma conta própria para ele, a parte visível da migração é simples: arquivos, banco de dados, certificado, cron. Tudo isso tem ferramenta pronta e o cliente percebe na hora se falhou, porque o site cai.

As caixas de e-mail são o contrário. Elas não caem, elas simplesmente aparecem vazias no servidor novo, e o cliente descobre isso na segunda-feira seguinte procurando um orçamento de três meses atrás.

O motivo é estrutural. As contas de e-mail de um domínio adicional pertencem ao usuário cPanel da conta principal, não ao domínio. Elas moram no diretório de correio daquele usuário. Quando o domínio adicional vira uma conta separada, com outro usuário, outro home e outra cota, não existe nada que faça essas caixas atravessarem sozinhas. A própria cPanel mantém um artigo de base de conhecimento dedicado a esse cenário, [How to Migrate the Contents of Email Accounts in Addon Domains](https://docs.cpanel.net/knowledge-base/email/how-to-migrate-the-contents-of-email-accounts-in-addon-domains/), o que já diz bastante sobre quantas migrações esbarram nisso.

Este artigo cobre o caminho que funciona sem acesso root nos dois lados: cópia IMAP a IMAP, com conferência pasta por pasta antes de encostar no domínio adicional da conta antiga. Não há medição própria aqui. Os parâmetros de protocolo são os padrões de IMAP e o caso está documentado pela cPanel no link acima; o resto é organização da tarefa.

## O que a cópia IMAP leva e o que você refaz na mão

A cópia IMAP move mensagem. Ela não move configuração de conta. Essa distinção é a origem de quase todo retrabalho pós-migração, então vale imprimir a tabela e usá-la como inventário da conta antiga antes de começar.

| Item | Onde ver na conta de origem | Vai junto na cópia IMAP |
|---|---|---||
| Mensagens da INBOX | Webmail ou cliente de e-mail | Sim |
| Enviados, Rascunhos, Lixeira, Spam | Mesma conexão IMAP | Sim, se você incluir as pastas |
| Subpastas e hierarquia | Mesma conexão IMAP | Sim |
| Flags de lido, respondido, favorito | Mesma conexão IMAP | Sim, com ferramenta que preserve flags |
| Data interna da mensagem | Mesma conexão IMAP | Sim, com ferramenta que preserve a data |
| Senha da caixa | Contas de E-mail | Não, você define no destino |
| Cota de disco da caixa | Contas de E-mail | Não |
| Filtros por conta e filtros globais | Filtros de E-mail | Não |
| Encaminhadores | Encaminhadores | Não |
| Respostas automáticas | Respondedores Automáticos | Não |
| Endereço padrão, o catch-all | Endereço Padrão | Não |
| Listas de discussão | Listas de Discussão | Não |
| SPF, DKIM, DMARC | Zona DNS e área de entregabilidade | Não, refazer no destino |

O detalhe que morde é o filtro. Um cliente que há anos manda tudo de `nfe@` para uma pasta Fiscal vai continuar recebendo na INBOX depois da migração e vai achar que você perdeu as mensagens antigas. Elas estão lá, na pasta certa, copiadas. O que sumiu foi a regra que alimentava a pasta.

## Os cinco itens que precisam estar na mesa antes de começar

Reúna estes cinco itens. Faltando qualquer um, a janela vira improviso.

**Senha de cada caixa.** A cópia IMAP autentica como o usuário. Você precisa da senha atual de cada conta na origem ou precisa redefinir cada uma, o que quebra o cliente de e-mail do usuário e exige aviso prévio. Se for redefinir, redefina no mesmo dia da cópia e já defina a mesma senha no destino: o cliente reconfigura uma vez só.

**Hostname direto dos dois servidores.** Não use `mail.dominio.com.br` em nenhum dos lados. Esse nome vai apontar para um servidor diferente antes e depois da virada de DNS, e durante a janela você precisa falar com os dois ao mesmo tempo. Use o hostname próprio de cada servidor. Prefira hostname a IP, porque o certificado TLS bate com o nome e você evita ter que desligar validação.

**Portas 993 ou 143 alcançáveis.** 993 é IMAP sobre TLS implícito, 143 é IMAP com STARTTLS. Teste antes, do mesmo lugar de onde você vai rodar a cópia:

```bash
# origem, TLS implícito na 993
openssl s_client -connect srv-origem.exemplo.com.br:993 \
  -servername srv-origem.exemplo.com.br </dev/null | head -20

# destino, STARTTLS na 143
openssl s_client -starttls imap \
  -connect srv-destino.exemplo.com.br:143 </dev/null | head -20
```

O que você espera ver: o certificado do servidor e uma linha de saudação IMAP começando com `* OK`. Se travar sem resposta, é firewall ou bloqueio de saída do seu provedor de internet, e vale rodar a cópia de um VPS em vez do notebook do escritório.

**Domínio ainda resolvendo e recebendo na origem.** Não mexa no DNS antes de copiar. A origem precisa continuar entregando e-mail durante todo o processo, porque é dela que você lê.

**Inventário das caixas.** Liste endereço, cota usada e cota máxima. Caixa com muitos gigabytes e dezenas de milhares de mensagens não copia em cinco minutos, e a cota no destino precisa ser igual ou maior, senão a cópia para no meio com erro de espaço.

## A ordem de execução que evita retrabalho

### Inventariar a conta antiga antes de criar qualquer coisa

Antes de criar qualquer coisa, tire print ou exporte as listas de contas de e-mail, encaminhadores, respondedores automáticos, filtros globais e filtros por conta, além do endereço padrão. Cinco minutos aqui economizam a semana seguinte.

### Criar as caixas no destino sem liberar o cliente

Crie as contas com o mesmo endereço, a mesma senha e cota igual ou maior. Não avise o cliente ainda e não mande ninguém reconfigurar cliente de e-mail. Caixa nova com cliente conectado antes da cópia é a receita para mensagem duplicada, mensagem apagada por engano e, no pior caso, POP3 com "remover do servidor" ligado apontando para a origem.

### Testar credencial e conexão antes de copiar de verdade

Com `imapsync`, o teste de credencial é isolado do resto:

```bash
imapsync \
  --host1 srv-origem.exemplo.com.br  --port1 993 --ssl1 \
  --user1 'contato@dominioadicional.com.br' --password1 'SENHA_ORIGEM' \
  --host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
  --user2 'contato@dominioadicional.com.br' --password2 'SENHA_DESTINO' \
  --justconnect
```

Os nomes de servidor e o endereço acima são exemplos fictícios. Trocando `--justconnect` por `--justfoldersizes`, a ferramenta lista as pastas dos dois lados com contagem de mensagens. Guarde essa saída: é a sua linha de base para a conferência.

### Rodar em seco e conferir o mapeamento das pastas

`--dry` executa tudo sem gravar nada no destino. É onde você descobre que a pasta de enviados na origem se chama `INBOX.Sent` e no destino `Enviados`. A opção `--automap` tenta casar as pastas especiais entre servidores com nomenclaturas diferentes:

```bash
imapsync \
  --host1 srv-origem.exemplo.com.br  --port1 993 --ssl1 \
  --user1 'contato@dominioadicional.com.br' --password1 'SENHA_ORIGEM' \
  --host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
  --user2 'contato@dominioadicional.com.br' --password2 'SENHA_DESTINO' \
  --automap --dry
```

Confira o mapeamento na saída. Se alguma pasta ficou fora ou foi para o lugar errado, corrija o mapeamento antes de rodar sem `--dry`.

### Repetir para todas as caixas, com laço ou pelo Thunderbird

Com mais de três ou quatro contas, monte um arquivo de credenciais e um laço. Exemplo:

```bash
# caixas.csv -> usuario;senha_origem;senha_destino
mkdir -p logs
while IFS=';' read -r usuario senha1 senha2; do
  echo "== $usuario"
  imapsync \
    --host1 srv-origem.exemplo.com.br  --port1 993 --ssl1 \
    --user1 "$usuario" --password1 "$senha1" \
    --host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
    --user2 "$usuario" --password2 "$senha2" \
    --automap </dev/null >> "logs/${usuario}.log" 2>&1
done < caixas.csv
```

O `</dev/null` evita que o comando consuma as linhas restantes do arquivo. Depois de terminar, `chmod 600` não basta: apague o CSV de senhas.

Sem terminal disponível, o plano B é o Thunderbird com as duas contas configuradas como IMAP, arrastando pastas da origem para o destino. Não é equivalente à cópia por ferramenta dedicada: o arrasto pode reescrever a data interna de parte das mensagens, que aparecem no destino com a data da cópia, e perder flags como respondido e favorito. Além disso é mais lento e engasga em pastas muito grandes. Se for esse o caminho, copie em blocos, confira ao final de cada bloco e avise o cliente de que a ordenação por data pode sair alterada em algumas pastas.

### Conferir pasta por pasta com a tabela preenchida

Detalhado na próxima seção. É o passo que ninguém pula duas vezes.

### Virar o DNS e rodar a segunda passada no dia seguinte

Com a conferência fechada, mude o MX e os demais registros. Enquanto o DNS propaga, mensagens novas ainda chegam na origem. Rode o mesmo comando outra vez no dia seguinte: em execução repetida, a ferramenta copia só o que falta e não duplica o que já foi. Aí sim libere o cliente para reconfigurar os dispositivos.

## Como contar as mensagens e qual diferença é aceitável

Contagem de mensagens na origem contra contagem no destino, pasta a pasta, incluindo as que ninguém lembra. Preencha uma linha por pasta de cada caixa:

| Pasta na origem | Nome no destino | Msgs origem | Msgs destino | Confere |
|---|---|---|---|---||
| INBOX | INBOX |  |  |  |
| INBOX.Sent | Enviados |  |  |  |
| INBOX.Drafts | Rascunhos |  |  |  |
| INBOX.Trash | Lixeira |  |  |  |
| INBOX.Junk | Spam |  |  |  |
| INBOX.Clientes | Clientes |  |  |  |
| INBOX.Clientes.2023 | Clientes/2023 |  |  |  |

Três observações sobre a contagem.

Diferença pequena na Lixeira e no Spam é comum e aceitável, porque muitos servidores apagam automaticamente mensagens antigas dessas pastas enquanto você copia. Diferença em INBOX, Enviados ou em qualquer pasta de arquivo do cliente não é aceitável, e a causa costuma estar no log: mensagem recusada por tamanho, cabeçalho malformado, cota estourada no destino.

Subpasta de terceiro nível é onde o mapeamento quebra. Servidores que usam ponto como separador e servidores que usam barra produzem árvores diferentes. Se a hierarquia saiu achatada no destino, pare, apague a caixa no destino, recrie e rode de novo com o mapeamento correto. Corrigir depois, com o cliente já usando, é muito pior.

Pastas com acento e pastas compartilhadas merecem verificação manual no webmail do destino, não só na contagem.

## Quatro erros que custam caro nessa migração

**Criar as contas no destino e liberar o cliente antes de copiar.** O usuário reconfigura o celular, o celular conecta na caixa vazia do servidor novo, e se o cliente de e-mail estiver em POP3 com remoção do servidor, ele pode apagar da origem o que você ainda não copiou. Crie as contas, copie, confira, e só então avise.

**Copiar só a INBOX.** É o erro mais comum de quem arrasta pastas na mão e cansa no meio. Enviados costuma ser a pasta mais valiosa do escritório, porque é onde estão as propostas mandadas. Lixeira também: gente usa a lixeira como arquivo morto, gostemos ou não.

**Apagar o domínio adicional da conta antiga no mesmo dia.** Trate a remoção do domínio adicional como operação destrutiva sobre as caixas daquele domínio: elas deixam de existir dentro da conta principal junto com o domínio, e não há garantia de que o diretório de correio permaneça acessível depois. Não confie na memória nem neste texto para decidir, confirme o comportamento no seu servidor antes de confirmar a remoção, lendo o aviso que o próprio painel exibe na tela de remoção do domínio adicional e checando o conteúdo do diretório de correio em uma conta de teste. A regra prática continua a mesma nos dois casos: tire um backup completo da conta antiga antes de remover qualquer coisa e deixe a conta antiga intacta por pelo menos duas semanas depois da virada, tempo suficiente para o cliente descobrir a pasta que faltou.

**Esquecer filtros, encaminhadores e respostas automáticas.** Recrie tudo no destino no mesmo dia da virada, usando o inventário do passo 1. Encaminhador esquecido é o pior dos três, porque ninguém reclama: a mensagem simplesmente para de chegar no endereço de destino e a falha só aparece quando alguém cobra uma resposta.

Um quinto, menos caro mas irritante: usar `mail.dominio.com.br` nos parâmetros de conexão. Durante a janela esse nome muda de dono, e você pode acabar copiando o servidor novo para dentro dele mesmo.

## A frase pronta para explicar a janela ao cliente

A conversa difícil não é técnica, é de expectativa. O cliente acha que o e-mail "vai junto com o site" porque para ele é o mesmo domínio. Frase pronta, adapte os horários:

> **** "O site e os arquivos já estão no servidor novo. O histórico de e-mail não vem junto automaticamente: as caixas do seu domínio ficavam hospedadas dentro de outra conta, com outro espaço em disco, e cada mensagem precisa ser copiada uma a uma pela mesma conexão que o seu programa de e-mail usa. Vou fazer essa cópia entre 20h e 23h de quinta. Na sexta eu confiro pasta por pasta e altero o endereçamento do domínio; no sábado rodo uma segunda passada para trazer o que chegou durante a troca. Até lá, nada muda para vocês: continuem usando o e-mail como sempre, só peço que ninguém apague mensagem, mova mensagem de pasta ou esvazie a lixeira a partir de quinta à noite, porque o que for apagado nesse intervalo pode reaparecer no servidor novo. Na segunda de manhã eu envio as instruções de reconfiguração dos aparelhos e acompanho a virada com vocês."

Duas coisas importam nessa frase. Ela explica a causa sem jargão, e ela transforma "não mexa" em uma instrução operacional com prazo. A caixa não fica tecnicamente em somente leitura no servidor, quem impõe isso é o combinado; se o cliente apagar cem mensagens durante a janela, elas voltam na sincronização seguinte e ele vai achar que o servidor novo está com defeito.

## Checklist para reutilizar em todo desmembramento

- [ ] Inventário exportado: contas, cotas, filtros globais e por conta, encaminhadores, respondedores, endereço padrão, listas
- [ ] Senha de cada caixa em mãos ou plano de redefinição comunicado
- [ ] Hostname direto dos dois servidores testado com `openssl s_client` na 993 ou na 143
- [ ] Cotas no destino iguais ou maiores que o uso atual na origem
- [ ] Contas criadas no destino, cliente ainda não avisado
- [ ] Execução com `--dry` revisada, mapeamento de Enviados, Lixeira, Spam e Rascunhos conferido
- [ ] Cópia concluída com log salvo por caixa
- [ ] Tabela de conferência preenchida, pasta a pasta, incluindo subpastas
- [ ] Filtros, encaminhadores e respostas automáticas recriados no destino
- [ ] SPF, DKIM e DMARC publicados apontando para o servidor novo
- [ ] DNS e MX alterados
- [ ] Segunda passada de sincronização rodada no dia seguinte
- [ ] Cliente avisado e dispositivos reconfigurados
- [ ] Backup completo da conta antiga guardado
- [ ] Domínio adicional removido da conta antiga, não antes de duas semanas

O item que você mais vai querer pular é a tabela de conferência. É justamente o único que prova, para você e para o cliente, que nada ficou para trás antes de apagar a origem.

