E-mail conecta mas a caixa fica vazia depois da migração
A conta loga, o disco está ocupado e a INBOX lista zero. A ordem de checagem antes de mexer, o reparo de dono e permissão e o passo que apaga as mensagens do cliente se você inverter a sequência.

Resposta curta: caixa vazia depois de migração quase nunca é mensagem perdida: os arquivos seguem em /home/usuario/mail/dominio/conta e a listagem só quebra por dono errado ou por diretório sem bit de execução. Confirme cur/new antes de tocar em qualquer coisa e nunca recrie a conta primeiro.
Neste artigo
- A conta autentica, a INBOX lista zero mensagem
- Prove que as mensagens estão no disco antes de corrigir qualquer coisa
- Ler o resultado antes de escolher a correção
- Corrigir dono e permissão da Maildir
- Quando as pastas somem mas as mensagens ficam
- Recriar a conta nunca é o primeiro passo
- Checklist em lote para carteira migrada
- Como explicar ao cliente sem gerar pânico
A conta autentica, a INBOX lista zero mensagem
O cliente configura o Outlook ou o Thunderbird, a senha é aceita, a conta conecta. E a INBOX aparece vazia. No webmail, a mesma coisa: entra, não dá erro, não tem mensagem. O disco da conta, no entanto, continua ocupado.
Esses dois fatos juntos, autenticação OK e lista vazia, apontam para um lugar só: autenticação e leitura de arquivo são etapas diferentes. O login é validado contra a base de contas do cPanel. A listagem de mensagens depende do servidor IMAP conseguir abrir os diretórios da Maildir em /home/usuario/mail/dominio/conta. Se o dono veio errado da migração, ou se os diretórios perderam o bit de execução, o processo que roda como o usuário da conta não consegue percorrer nada, e uma Maildir ilegível se comporta exatamente como uma Maildir vazia.
Pré-requisito de acesso. O diagnóstico e o reparo descritos aqui exigem SSH como root no servidor ou WHM. Se você administra sites em revenda ou compartilhado e só tem cPanel, você consegue fazer parte da verificação pelo Gerenciador de Arquivos (ver se cur e new existem e têm mensagens dentro de mail/dominio/conta), mas não consegue corrigir dono. Nesse caso, pule para a subseção "Se você só tem cPanel" e abra chamado com as informações certas em vez de tentar contornar.
Não há medição própria neste artigo. O que vem abaixo é procedimento de diagnóstico e a ferramenta documentada do WHM para corrigir dono e permissão de caixas.
Prove que as mensagens estão no disco antes de corrigir qualquer coisa
Essa é a parte que agência migrando carteira costuma pular, e é a que decide todo o resto. Enquanto você não confirmar que os arquivos existem, qualquer correção é chute, e chute em servidor de e-mail apaga mensagem.
Localize a Maildir da conta em /home/usuario/mail
Contas de e-mail de domínio ficam em /home/usuario/mail/dominio/conta. A caixa padrão do próprio usuário do cPanel fica um nível acima, em /home/usuario/mail, com cur e new direto ali.
ls -la /home/usuario/mail/exemplo.com.br/contato/
Você espera ver, no mínimo, cur, new e tmp. Se esses três diretórios não existem, o problema não é permissão, é que a Maildir não foi copiada.
Conte os arquivos em cur e em new
ls -1 /home/usuario/mail/exemplo.com.br/contato/cur | wc -l
ls -1 /home/usuario/mail/exemplo.com.br/contato/new | wc -l
du -sh /home/usuario/mail/exemplo.com.br/contato/
cur guarda as mensagens já vistas pelo cliente, new guarda as que ainda não foram entregues ao cliente. Contagem alta em cur com INBOX vazia no webmail é a assinatura clássica do problema de leitura.
Compare dono e permissão com uma conta que funciona
Este passo evita que você invente o valor "certo" de permissão. Pegue uma conta do mesmo servidor que está listando mensagens normalmente e compare:
stat -c '%U:%G %a %n' /home/usuario/mail/exemplo.com.br/contato \
/home/usuario/mail/exemplo.com.br/contato/cur
stat -c '%U:%G %a %n' /home/outro/mail/outrodominio.com.br/financeiro \
/home/outro/mail/outrodominio.com.br/financeiro/cur
Duas coisas diferentes saem daí, e vale não misturar:
- O que quebra a listagem: dono diferente do usuário cPanel da conta (
root:root,nobody, ou o usuário do servidor de origem), ou diretório sem bit de execução para o dono, tipicamente0644ou0600num diretório. Semxno diretório, o processo não entra nele, e a pasta responde como vazia. - O que é padrão, não condição de leitura:
0700nos diretórios da Maildir e0600nos arquivos, com dono e grupo do usuário cPanel (usuario:usuario). É o padrão que o cPanel aplica e o que você deve deixar no final. Um diretório0755com arquivos0644pertencentes ao usuário é lido normalmente pelo IMAP: está fora do padrão e expõe a caixa a mais gente do que devia, mas não é a causa de INBOX vazia.
Faça o backup da caixa antes de mexer em dono ou modo
tar -czf /root/maildir-contato-$(date +%F).tar.gz \
-C /home/usuario/mail/exemplo.com.br contato
Custa segundos e é o que separa "corrigi a permissão" de "apaguei a caixa do cliente".
Ler o resultado antes de escolher a correção
| O que você viu | Leitura provável | Ação |
|---|---|---|
cur com muitos arquivos, dono root ou usuário de outro servidor |
Dono errado depois de restauração ou rsync como root |
Corrigir dono e, na sequência, normalizar a permissão |
cur com arquivos, dono correto, diretórios sem bit de execução (0644, 0600) |
chmod -R achatou diretório e arquivo no mesmo modo |
Corrigir só a permissão, separando diretório de arquivo |
cur com arquivos, dono correto, diretórios 0755 e arquivos 0644 |
Fora do padrão do cPanel, mas legível | Não é a causa da caixa vazia; normalize depois e continue procurando |
cur e new vazios, du perto de zero |
A Maildir não veio na migração | Voltar ao backup ou refazer a transferência, não mexer em permissão |
Mensagens em cur, mas pastas do cliente sumiram |
Arquivo de assinatura IMAP perdido | Reassinar as pastas, ver seção específica |
| Tudo certo no disco e ainda vazio no cliente | O cliente pode estar conectando no servidor antigo | Conferir para onde o hostname de e-mail resolve antes de mexer no servidor novo |
A última linha é a que mais economiza trabalho. Se o registro de e-mail do domínio ainda aponta para a hospedagem antiga, ou se o cliente tem um mail.dominio fixado no arquivo de hosts dele, nenhuma correção de permissão vai mudar o que ele vê. Teste com o webmail do servidor novo acessado pelo IP ou pelo hostname do servidor, não pelo domínio do cliente.
Corrigir dono e permissão da Maildir
Repair Mailbox Permissions, a ferramenta do WHM para várias contas
O cPanel tem uma interface própria para isso, em WHM > Email > Repair Mailbox Permissions. Segundo a documentação oficial do cPanel, a ferramenta corrige dono e permissão dos arquivos de caixa de correio das contas cPanel que você selecionar na lista. É isso que a página descreve, e é só isso que eu afirmo sobre o que ela faz.
Recomendo essa opção para agência por dois motivos práticos, e aqui é avaliação minha, não documentação: ela trata várias contas em uma única passada, o que importa quando você migrou uma carteira inteira, e não depende de você acertar a sintaxe de um find às onze da noite.
Depois de rodar, repita o stat do passo 3. Se o dono e o modo mudaram para o padrão da conta saudável, siga para a validação.
Correção manual por SSH, uma caixa por vez
Use quando você quer tratar uma única caixa e já sabe exatamente o que está errado.
CAIXA=/home/usuario/mail/exemplo.com.br/contato
chown -R usuario:usuario "$CAIXA"
find "$CAIXA" -type d -exec chmod 0700 {} +
find "$CAIXA" -type f -exec chmod 0600 {} +
Repare que diretório e arquivo são tratados em comandos separados. Um chmod -R 0700 no caminho inteiro deixaria todo arquivo de mensagem com bit de execução, e um chmod -R 0600 tiraria o bit de entrada dos diretórios, o que quebra a caixa de um jeito novo. Achatar permissão com -R é a forma mais comum de transformar um problema pequeno em um problema grande.
Não saia aplicando isso em /home/usuario/mail inteiro por reflexo: o diretório mail do usuário e alguns diretórios de serviço do cPanel não usam necessariamente o mesmo modo das pastas internas da Maildir. Se a dúvida aparecer, volte para a opção A.
Se você só tem cPanel, sem WHM e sem SSH
Sem WHM e sem SSH, você não corrige dono. O que dá para fazer, e adianta muito o chamado, é levar o diagnóstico pronto. Pelo Gerenciador de Arquivos, com "mostrar arquivos ocultos" ligado, abra mail/dominio/conta e anote:
- o caminho completo da Maildir da conta afetada;
- se
cur,newetmpexistem; - quantos arquivos há em
cure emnew(o Gerenciador de Arquivos mostra a contagem ao abrir a pasta); - o dono e a permissão que a interface exibe para
cur, se ela exibir; - o uso de disco da conta de e-mail, na tela de contas de e-mail;
- o resultado do teste no webmail do servidor, não no Outlook.
Texto pronto para o chamado: "A conta [email protected] autentica normalmente no webmail, mas a INBOX lista zero mensagem. A pasta mail/exemplo.com.br/contato/cur tem 4.312 arquivos e a conta ocupa 2,1 GB. Suspeito de dono ou permissão errada na Maildir depois da migração. Peço reparo de permissões de caixa nessa conta. Não recriem a conta." Essa última frase evita o pior desfecho possível.
Validar no webmail do servidor, não no Outlook do cliente
Valide sempre no webmail do servidor, não no Outlook do cliente. O cliente desktop tem cache local, índice próprio e pode mostrar o estado antigo por minutos. Abra o webmail, entre na conta, confira se a INBOX lista, se as pastas aparecem e se uma mensagem antiga abre de verdade, com corpo e anexo. Só depois peça para o cliente testar.
Quando as pastas somem mas as mensagens ficam
Outro cenário pós-migração: a INBOX volta, mas as pastas que o cliente tinha (Arquivo, Clientes, 2024) não aparecem no programa de e-mail, embora os diretórios com ponto na frente estejam lá no disco, cheios de mensagens.
No formato Maildir++, cada pasta é um diretório iniciado por ponto, com seus próprios cur, new e tmp. A lista do que o cliente IMAP enxerga vem de um arquivo de assinaturas dentro da caixa, e esse arquivo, ou a cota e os índices, é o tipo de coisa que se perde ou vem com dono errado na cópia.
ls -la /home/usuario/mail/exemplo.com.br/contato/ | grep '^d' | head -20
O que é recriável sem perder mensagem:
| Arquivo | Para que serve | Se sumir ou vier corrompido |
|---|---|---|
subscriptions |
Lista de pastas assinadas no IMAP | Pasta existe no disco mas não aparece no cliente; reassinar resolve |
maildirsize |
Cache do cálculo de cota | É recalculado; caixa pode aparecer cheia até recalcular |
dovecot-uidlist e dovecot.index* |
Índice e numeração das mensagens | São reconstruídos na próxima leitura da pasta |
Mensagem nenhuma está nesses arquivos. As mensagens são os arquivos soltos dentro de cur e new. Por isso apagar índice é operação de baixo risco, desde que o backup da seção anterior já esteja feito, e que você apague com alvo explícito, nunca com curinga solto no diretório.
Para as pastas voltarem à vista do cliente, o caminho mais seguro é abrir o webmail e reassinar as pastas na tela de gerenciamento de pastas. Isso regrava o arquivo de assinaturas com o dono correto, sem você editar nada na mão. Se o problema for só de dispositivo, a assinatura IMAP também explica pasta que aparece no webmail e não no celular.
Recriar a conta nunca é o primeiro passo
A reação padrão de quem está com pressa é apagar a conta no cPanel e criar de novo com a mesma senha, porque "assim ela nasce limpa". Nasce mesmo. Sem as mensagens.
Remover uma conta de e-mail remove o diretório da caixa junto. As mensagens que estavam ilegíveis por permissão, e que seriam recuperadas com um reparo de cinco minutos, viram restauração de backup, se houver backup, e perda definitiva, se não houver. É o único passo desse roteiro que não tem volta.
Ordem fixa, e vale colar no runbook da agência:
- Confirmar que
curenewtêm arquivos. - Fazer o
tarda caixa. - Corrigir dono e permissão (WHM, SSH ou chamado, conforme o seu acesso).
- Validar no webmail.
- Reassinar pastas, se for o caso.
- Só então, se o disco estiver realmente vazio e o backup confirmar que nunca houve mensagem, considerar recriar a conta.
Checklist em lote para carteira migrada
Quem migrou trinta contas não vai auditar uma por uma na mão. Rode primeiro um levantamento que só lê, sem alterar nada, e olhe o resultado antes de decidir. Os dois comandos abaixo precisam de root.
# Inventário: dono, grupo, modo e contagem de mensagens de cada caixa
for d in /home/*/mail/*/*; do
[ -d "$d/cur" ] || continue
dono=$(stat -c '%U:%G %a' "$d")
qtd=$(ls -1 "$d/cur" | wc -l)
echo "$dono cur=$qtd $d"
done | sort
Com o sort no fim do laço, a saída sai agrupada por dono e as linhas que destoam do padrão do servidor ficam visíveis em bloco.
O teste que realmente isola a caixa quebrada não é contar quantos donos existem (num servidor com várias contas cPanel, um dono por conta é o estado normal), e sim comparar o dono de cada Maildir com o dono do /home correspondente:
# Lista só as caixas cujo dono diverge do dono do home do usuário
for d in /home/*/mail/*/*; do
[ -d "$d/cur" ] || continue
home=$(echo "$d" | cut -d/ -f1-3)
esperado=$(stat -c '%U' "$home")
atual=$(stat -c '%U' "$d")
[ "$atual" = "$esperado" ] && continue
echo "DIVERGENTE esperado=$esperado atual=$atual $d"
done
Saída vazia significa que dono não é o seu problema, e você volta a olhar bit de execução de diretório, rota de DNS ou cache do cliente. Saída com linhas te dá exatamente a lista de contas cPanel a selecionar na tela Repair Mailbox Permissions do WHM, o que é mais rápido e mais seguro do que um chown recursivo improvisado em /home.
Checklist para fechar o chamado:
- [ ]
cur/newexistem e têm arquivos - [ ] backup
.tar.gzda caixa feito e guardado fora do/home - [ ] dono e grupo iguais ao dono do
/homedo usuário cPanel - [ ] diretórios com bit de execução para o dono, no padrão
0700, arquivos0600 - [ ] webmail lista mensagens e abre uma mensagem antiga com anexo
- [ ] pastas do cliente visíveis e assinadas
- [ ] cota da conta coerente com o
du -shda caixa - [ ] cliente testou no programa dele, depois do webmail
- [ ] registros de e-mail do domínio apontando para o servidor novo
Como explicar ao cliente sem gerar pânico
O cliente que abre o Outlook e vê a caixa vazia já assumiu que perdeu tudo. A explicação precisa desarmar isso na primeira frase, antes de qualquer detalhe técnico.
Duas orientações que valem junto com a frase, e que evitam o chamado seguinte: peça para o cliente não apagar e recriar a conta no programa de e-mail enquanto você trabalha, e avise que, em conta IMAP antiga, o cliente desktop pode levar alguns minutos para recarregar o índice depois do reparo. Se ele confirmar no webmail antes, a ansiedade acaba ali.
Referências
- Documentação oficial (cpanel) — Repair Mailbox Permissions. Consultado em 2026-09-24.