blog
Painéis

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.

JR · · 7 min de leitura · 1 tabela · 3 blocos de código

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
  1. O sintoma: login passa, lista de pastas vem vazia
  2. Três confirmações antes de rodar o reparo
  3. Onde fica o Repair Mailbox Permissions no WHM
  4. Os três erros que mais custam tempo nesse diagnóstico
  5. Checklist para validar contas depois de restauração ou migração
  6. O que escrever para o usuário final antes e depois do reparo
  7. 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.

Triagem: qual causa está na sua frenteLogin falhaSenha ou conta inexistenteAutentica e não lista nadaPermissão de mailboxLista pasta sem mensagemÍndice do DovecotDiretório vazio em discoBackup incompleto ou POP3
Separe a causa antes de rodar qualquer reparo no WHM.

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

  1. 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.
  2. Vá em Email » Repair Mailbox Permissions.
  3. 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.
  4. Execute o reparo e aguarde a saída na tela.
  5. 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:

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.

Reparo de permissões, do preparo à validaçãoConfirmar conta cPanelList Accounts pelo domínioCopiar pasta mailtar ou Gerenciador de ArquivosRodar reparo em loteEmail, Repair Mailbox PermissionsLer a saídaContas processadas e falhasValidar no webmailPastas e mensagem antiga
Sequência aplicada por conta cPanel, com validação uma a uma.

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.

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:

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

  1. Documentação oficial (cpanel) — Repair Mailbox Permissions. Consultado em 2026-10-27.
Leia também