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.

Resposta curta: 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.
Neste artigo
- Por que as caixas do domínio adicional não viajam com os arquivos
- O que a cópia IMAP leva e o que você refaz na mão
- Os cinco itens que precisam estar na mesa antes de começar
- A ordem de execução que evita retrabalho
- Como contar as mensagens e qual diferença é aceitável
- Quatro erros que custam caro nessa migração
- A frase pronta para explicar a janela ao cliente
- Checklist para reutilizar em todo desmembramento
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, 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:
# 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:
imapsync \
--host1 srv-origem.exemplo.com.br --port1 993 --ssl1 \
--user1 '[email protected]' --password1 'SENHA_ORIGEM' \
--host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
--user2 '[email protected]' --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:
imapsync \
--host1 srv-origem.exemplo.com.br --port1 993 --ssl1 \
--user1 '[email protected]' --password1 'SENHA_ORIGEM' \
--host2 srv-destino.exemplo.com.br --port2 993 --ssl2 \
--user2 '[email protected]' --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:
# 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:
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_clientna 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
--dryrevisada, 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.
Referências
- Documentação oficial (cpanel) — How to Migrate the Contents of Email Accounts in Addon Domains. Consultado em 2026-09-20.