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.

Resposta curta: 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.
Neste artigo
- O sintoma: login passa, lista de pastas vem vazia
- Três confirmações antes de rodar o reparo
- Onde fica o Repair Mailbox Permissions no WHM
- Os três erros que mais custam tempo nesse diagnóstico
- Checklist para validar contas depois de restauração ou migração
- O que escrever para o usuário final antes e depois do reparo
- Quando é índice do Dovecot, POP3 ou backup incompleto, e não permissão
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. 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 ([email protected], 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 [email protected] 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, 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 -shno 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
maildas 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:
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:
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/contaainda 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, 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.
Referências
- Documentação oficial (cpanel) — Repair Mailbox Permissions. Consultado em 2026-10-27.