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

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

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

---

## 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, tipicamente `0644` ou `0600` num diretório. Sem `x` no diretório, o processo não entra nele, e a pasta responde como vazia.
- **O que é padrão, não condição de leitura:** `0700` nos diretórios da Maildir e `0600` nos 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ório `0755` com arquivos `0644` pertencentes 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](https://docs.cpanel.net/whm/email/repair-mailbox-permissions/), 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`, `new` e `tmp` existem;
- quantos arquivos há em `cur` e em `new` (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 contato@exemplo.com.br 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 `cur` e `new` têm arquivos.
- Fazer o `tar` da 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`/`new` existem e têm arquivos
- [ ] backup `.tar.gz` da caixa feito e guardado fora do `/home`
- [ ] dono e grupo iguais ao dono do `/home` do usuário cPanel
- [ ] diretórios com bit de execução para o dono, no padrão `0700`, arquivos `0600`
- [ ] webmail lista mensagens e abre uma mensagem antiga com anexo
- [ ] pastas do cliente visíveis e assinadas
- [ ] cota da conta coerente com o `du -sh` da 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.

> **** Suas mensagens não foram perdidas. Elas estão todas no servidor, no mesmo lugar de sempre. O que veio errado da migração foi a permissão de leitura dos arquivos, então o programa de e-mail pediu a lista de mensagens e o servidor não conseguiu abrir a pasta para responder. Estamos corrigindo a permissão. Quando terminar, as mensagens voltam a aparecer sozinhas, sem você precisar reconfigurar nada nem reenviar nada.

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.

