# E-mail conecta mas não mostra pastas: reparo no WHM

O reparo de permissões de caixas postais do WHM resolve o caso clássico pós-restauração. Pré-requisitos, execução, validação e os três erros que fazem o conserto parecer que falhou.

> na maioria dos casos em que o IMAP autentica mas não lista pastas, o problema é dono/permissão do diretório de correio, e o WHM resolve em 5 passos pela tela Email » Repair Mailbox Permissions, sem ticket e sem terminal.

João Rizzon · 2026-11-06 · Painéis

---

## O sintoma: login passa, lista de pastas vem vazia

O cliente liga dizendo que o e-mail "sumiu". Você testa: o login no Roundcube passa, a senha está certa, o Thunderbird conecta sem erro de autenticação. E a lista de pastas vem vazia, ou só com INBOX sem nenhuma mensagem.

Quando a autenticação funciona e a listagem não, o servidor está dizendo duas coisas ao mesmo tempo: o usuário existe e a senha confere, mas o processo que lê a caixa não consegue entrar no diretório de correio. Isso acontece com frequência depois de restaurar uma conta de backup, mover arquivos por SFTP com outro usuário, ou copiar a pasta `mail` à mão entre servidores. O conteúdo está lá, o dono e as permissões é que não batem.

O cPanel/WHM tem uma função específica para isso, documentada como [Repair Mailbox Permissions](https://docs.cpanel.net/whm/email/repair-mailbox-permissions/). Ela corrige propriedade e permissões dos diretórios de e-mail das contas que você selecionar. É a rota de execução: não investiga, conserta.

## Três confirmações antes de rodar o reparo

Pular isso é o que faz a agência rodar o reparo na conta errada e continuar com o problema.

### Teste se a autenticação realmente passa pelo webmail ou pelo openssl

Se o login falha, o problema não é permissão de mailbox, é senha, usuário completo (`nome@dominio.com.br`, não só `nome`) ou a conta nem existe mais depois da restauração. Teste pelo webmail do próprio servidor, que elimina configuração do cliente de e-mail da equação.

Se quiser testar no terminal, o mínimo que prova o ponto:

```
openssl s_client -connect mail.exemplo.com.br:993 -crlf
a1 LOGIN usuario@exemplo.com.br senha
a2 LIST "" "*"
```

Se `a1` responde `OK` e `a2` volta sem pastas (ou só com INBOX), você está no cenário deste artigo. Se `a1` responde `NO`, pare: é outro problema.

### Descubra qual conta cPanel é dona do domínio

O reparo é aplicado por **conta cPanel**, não por endereço de e-mail. Em servidor com revenda ou com vários domínios adicionais, o domínio do cliente pode estar sob um usuário com nome que não lembra nada o domínio. Confirme no WHM, em **List Accounts**, buscando pelo domínio. Anote o usuário exato.

### Copie a pasta mail antes de mexer em conta de cliente

O reparo mexe em dono e permissões, não apaga mensagem. Ainda assim, antes de operar em conta de cliente, faça uma cópia. Pelo Gerenciador de Arquivos do cPanel, compacte a pasta `mail` da conta. Por SSH, um `tar` simples resolve:

```
tar -czf /home/usuario/mail-backup.tar.gz -C /home/usuario mail
```

Se algo der errado, você tem para onde voltar e tem o que mostrar ao cliente.

## Onde fica o Repair Mailbox Permissions no WHM

Segundo a [documentação oficial do cPanel](https://docs.cpanel.net/whm/email/repair-mailbox-permissions/), a interface fica no WHM, na seção **Email**, com o nome **Repair Mailbox Permissions**.

### Os cinco passos do reparo, incluindo o lote de várias contas

- Acesse o WHM com usuário root. Se você opera como revendedor, a disponibilidade da tela depende das permissões liberadas no seu servidor, confirme com quem administra a máquina.
- Vá em **Email » Repair Mailbox Permissions**.
- Selecione a conta cPanel que você anotou. Para lote, selecione várias contas de uma vez em vez de repetir o processo uma por uma.
- Execute o reparo e aguarde a saída na tela.
- Leia o resultado antes de fechar. A saída indica o que foi processado e eventuais falhas.

### Como confirmar que as pastas voltaram sem perguntar ao cliente

Não pergunte ao cliente, verifique você mesmo. Abra o webmail do servidor com a conta afetada e confira:

- as pastas voltaram a aparecer na barra lateral (INBOX, Enviados, Lixeira, subpastas do cliente);
- o tamanho da caixa mostrado no cPanel em **Contas de e-mail** bate com o tamanho em disco (`du -sh` no diretório da conta);
- abrir uma mensagem antiga funciona, não só listar.

Se as pastas voltaram no webmail mas não no Outlook ou Thunderbird do cliente, o servidor está resolvido e o que falta é do lado do cliente de e-mail.

## Os três erros que mais custam tempo nesse diagnóstico

| Erro | Sinal | O que fazer |
|---|---|---||
| Reparo rodado na conta cPanel errada | Saída "sem erros" e caixa continua vazia | Confirme o dono do domínio em List Accounts e repita na conta certa |
| Pastas IMAP não assinadas no cliente | Webmail mostra tudo, Outlook/Thunderbird mostra só INBOX | Marcar as pastas na assinatura IMAP do cliente de e-mail |
| Arquivos não vieram na restauração | Pasta `mail` existe mas quase sem conteúdo | Reparo não cria mensagem; refazer a restauração do backup |

O terceiro caso é o mais ingrato e vale checar antes de prometer prazo ao cliente. Se o diretório de correio está praticamente vazio em disco, nenhuma correção de permissão vai materializar mensagem. Dá para ver o tamanho rápido:

```
du -sh /home/usuario/mail/exemplo.com.br/*
```

Se a caixa que deveria ter anos de histórico aparece com poucos KB, o problema está no backup, não no servidor de e-mail. Nesse ponto a conversa com o cliente muda de "estou consertando" para "preciso de outro ponto de restauração".

## Checklist para validar contas depois de restauração ou migração

Use isto como item de processo depois de toda restauração ou migração de conta com e-mail, antes de devolver o acesso ao cliente. Em agência, vale colar no card da tarefa.

- [ ] Listar todas as contas cPanel restauradas no lote
- [ ] Para cada conta, testar login em um endereço de e-mail pelo webmail
- [ ] Comparar o tamanho da caixa no cPanel com o esperado pelo cliente
- [ ] Fazer cópia da pasta `mail` das contas que serão tocadas
- [ ] Rodar **Repair Mailbox Permissions** no WHM selecionando as contas do lote de uma vez
- [ ] Revalidar cada conta no webmail: pastas listadas e mensagem antiga abrindo
- [ ] Só então avisar os usuários finais
- [ ] Registrar no histórico do cliente a data da restauração e do reparo

O ganho de fazer em lote é concreto: você seleciona as contas de uma vez na mesma tela, em vez de abrir o processo por conta. A validação continua sendo uma por uma, e não tem atalho nisso.

## O que escrever para o usuário final antes e depois do reparo

Quem está do outro lado não quer saber de propriedade de diretório. Quer saber se perdeu e-mail. Duas frases prontas:

Para o usuário final, antes do reparo:

> **** Suas mensagens não foram apagadas. Depois da restauração do servidor, a caixa ficou com a permissão de acesso incorreta e o programa de e-mail não consegue listar as pastas. Vamos corrigir e avisamos quando estiver normalizado. Não apague e nem recrie a conta no seu programa de e-mail enquanto isso.

O último pedido é importante: usuário ansioso remove a conta do Outlook e recria, e em cenário com POP3 configurado para apagar do servidor isso pode piorar o quadro.

Para o cliente, depois do reparo, quando as mensagens não voltaram porque não estavam no backup:

> **** A permissão de acesso às caixas foi corrigida e o servidor está entregando normalmente o que existe em disco. As mensagens anteriores a [data] não estão presentes no ponto de restauração usado. Vou verificar pontos de backup anteriores e te retorno com o que é recuperável.

Dizer isso cedo é mais barato que dizer tarde.

## Quando é índice do Dovecot, POP3 ou backup incompleto, e não permissão

Nem todo "caixa vazia" é permissão. Três cenários em que rodar o reparo só queima tempo:

- **Login falha.** Problema de credencial ou de conta inexistente. Antes de pensar em recriar a conta, confirme se `/home/usuario/mail/dominio.com.br/conta` ainda existe e com qual tamanho. Remover a conta de e-mail pelo cPanel apaga o diretório de mensagens correspondente, então recriar sem cópia prévia destrói o que sobrou. Se o diretório existe, trate como senha ou como conta não recriada na restauração, não como caso de exclusão.
- **Conta configurada como POP3 com remoção do servidor.** O cliente baixou tudo para a máquina dele e o servidor está vazio de verdade. O reparo não muda nada.
- **Pastas aparecem e as mensagens não, só em algumas pastas.** Aí o suspeito é índice do Dovecot, não permissão. Reparo de permissão não reconstrói índice.

A regra prática: permissão explica caixa que autentica e não lista nada. Índice explica pasta que lista e não mostra mensagem. Backup explica diretório vazio em disco. Identificar qual dos três você tem na frente antes de agir economiza a tarde inteira.

Fonte do procedimento: documentação oficial do cPanel, [Repair Mailbox Permissions](https://docs.cpanel.net/whm/email/repair-mailbox-permissions/), consultada em 27/10/2026. Os caminhos de diretório e comandos de verificação deste artigo são exemplos de uso comum; adapte ao nome real do usuário e do domínio no seu servidor.

