Roundcube com DATABASE ERROR: como reconstruir sem perder e-mail
O que some e o que fica quando você reconstrói a base SQLite do Roundcube no cPanel, o passo a passo documentado e como confirmar pelo webmail que a caixa voltou inteira.

Resposta curta: a reconstrução da base do Roundcube apaga 0 mensagens: as mensagens ficam no servidor IMAP. Somem preferências, assinaturas e contatos salvos no webmail. No cPanel, basta renomear o arquivo .rcube.db da caixa e entrar de novo.
Neste artigo
O que o erro de banco do Roundcube quer dizer
A mensagem aparece logo depois do login, antes de qualquer pasta carregar: DATABASE ERROR: CONNECTION FAILED!, seguida de um pedido para contatar o administrador do servidor. O usuário digita a senha certa, o webmail recusa abrir, e o cliente liga achando que perdeu os e-mails.
Não perdeu. No cPanel, o Roundcube guarda os dados próprios de cada caixa em um arquivo SQLite individual, dentro da pasta etc da conta. A documentação oficial do cPanel trata esse erro como sinal de que o Roundcube não conseguiu usar esse arquivo, e a correção documentada é reconstruí-lo: tirar o arquivo antigo do caminho para que o Roundcube crie um novo no próximo acesso.
As mensagens não ficam nesse arquivo. Elas estão no servidor de e-mail (IMAP), em outra parte da conta. O SQLite do Roundcube guarda só o que é do webmail: preferências, identidades, contatos e cache. Por isso a reconstrução resolve o login sem tocar na caixa de entrada, mas cobra um preço que o cliente precisa conhecer antes.
O que a reconstrução apaga e o que preserva
Antes de rodar qualquer comando, combine com o cliente o que vai sumir. É a parte que gera reclamação depois, não o erro em si.
| Item | Onde fica | Depois da reconstrução |
|---|---|---|
| Mensagens de todas as pastas | Servidor IMAP (maildir da conta) | Preservado |
| Pastas criadas pelo usuário | Servidor IMAP | Preservado |
| Senha da caixa de e-mail | cPanel | Preservado |
| Preferências do Roundcube (idioma, fuso, layout, exibição) | SQLite do Roundcube | Apagado, volta ao padrão |
| Identidades e assinaturas | SQLite do Roundcube | Apagado |
| Catálogo de endereços do Roundcube | SQLite do Roundcube | Apagado |
| Respostas prontas do webmail | SQLite do Roundcube | Apagado |
| Filtros de e-mail do cPanel / Sieve | Servidor | Preservado |
| Cache de mensagens do webmail | SQLite do Roundcube | Recriado sozinho |
Dois pontos práticos. Primeiro: o arquivo antigo não precisa ser excluído, só renomeado. Se ele estiver legível, dá para tentar recuperar contatos depois, com calma, sem o cliente parado. Segundo: contatos que o usuário sincroniza pelo celular com o servidor de contatos do cPanel (CardDAV) não dependem do catálogo do Roundcube; o que some é o que foi salvo dentro do webmail.
Três checagens que evitam apagar preferências à toa
Reconstruir resolve arquivo corrompido. Não resolve causa que esteja fora dele. Três verificações rápidas evitam apagar preferências à toa (estas são checagens de operação, não fazem parte do procedimento documentado):
- Só uma caixa ou todas? Se todas as caixas do servidor dão o mesmo erro, o problema é de servidor, não do arquivo de um usuário. Nesse caso, abra chamado com a hospedagem em vez de reconstruir caixa por caixa.
- Espaço em disco da conta. Uma conta sem cota livre impede o SQLite de gravar. Confira o uso de disco no cPanel. Se estiver no limite, libere espaço e teste o login de novo antes de mexer no arquivo.
- A caixa abre por IMAP? Desde o cPanel 108 o Roundcube é o único webmail do cPanel, então o teste é um cliente IMAP. Se o celular ou o programa de desktop recebe e lista as mensagens normalmente, a caixa está íntegra e o problema está restrito ao Roundcube. É a confirmação que você quer para seguir.
Se o servidor tem sqlite3 instalado e você tem acesso ao terminal, dá para confirmar a corrupção antes de agir:
sqlite3 /home/usuario/etc/exemplo.com.br/contato.rcube.db "PRAGMA integrity_check;"
A resposta ok indica arquivo íntegro: aí a causa provavelmente é outra (cota, permissão, servidor). Qualquer outra saída, ou erro ao abrir o arquivo, reforça que a reconstrução é o caminho. Os nomes usuario, exemplo.com.br e contato são fictícios; troque pelos da conta.
Como reconstruir a base do Roundcube no cPanel
O procedimento documentado pelo cPanel se resume a renomear o arquivo SQLite do usuário afetado. Não exige reinstalar nada nem acesso root, porque o arquivo fica dentro do diretório da própria conta.
Localizar o arquivo certo
O nome do arquivo depende de qual caixa deu erro:
| Caixa afetada | Caminho do arquivo (exemplo) |
|---|---|
Conta de e-mail [email protected] |
/home/usuario/etc/exemplo.com.br/contato.rcube.db |
| Conta padrão do cPanel (login com o usuário do cPanel) | /home/usuario/etc/usuario.rcube.db |
Confira o caminho exato na documentação do cPanel se a estrutura da conta for diferente. Renomear o arquivo errado significa apagar as preferências de outra pessoa e manter o erro.
Renomear o arquivo
Pelo terminal, com o usuário da conta:
cd /home/usuario/etc/exemplo.com.br/
mv contato.rcube.db contato.rcube.db.bak
ls -l contato.rcube.db*
O ls deve listar só o .bak. Sem terminal, faça o mesmo pelo Gerenciador de Arquivos do cPanel: ative a exibição de arquivos ocultos se necessário, entre em etc, depois na pasta do domínio, e renomeie o arquivo acrescentando .bak no final.
Entrar de novo no webmail
Feche a aba do webmail e faça login outra vez. No primeiro acesso ele cria um arquivo .rcube.db novo e vazio. Se rodar o ls de novo, vai ver os dois arquivos lado a lado.
Se o erro persistir com o arquivo novo, a causa não era corrupção. Volte às checagens de cota e de servidor.
Conferir pelo próprio webmail que a caixa voltou
Não encerre o atendimento só porque a tela de erro sumiu. Confira no Roundcube, com o cliente junto se possível:
- Caixa de entrada lista as mensagens, incluindo as mais antigas. Role até o fim ou use a busca por um remetente conhecido.
- Todas as pastas aparecem: Enviados, Rascunhos, Lixeira e as pastas criadas pelo usuário. Se alguma pasta não aparecer, abra Configurações, Pastas, e veja se ela está apenas sem inscrição.
- Contagem de não lidas bate com o que o celular ou o cliente de desktop mostra.
- Envio funciona: mande uma mensagem de teste para outra caixa e confira se chegou e se ficou em Enviados.
- Refaça o que foi apagado: em Configurações, Identidades, recrie nome de exibição e assinatura. Ajuste idioma e fuso em Preferências.
Só depois disso o .bak pode ser arquivado ou excluído. Guarde por alguns dias: se o cliente lembrar de um contato importante que só existia no webmail, o arquivo antigo é a única chance de recuperar.
Como padronizar isso em vários sites de clientes
Quem mantém dezenas de domínios ganha tempo tratando o erro como checklist, não como investigação nova a cada vez:
- [ ] Confirmar se é uma caixa ou o servidor todo
- [ ] Verificar cota de disco da conta
- [ ] Avisar o cliente do que será apagado e obter o ok
- [ ] Identificar o arquivo
.rcube.dbda caixa certa - [ ] Renomear para
.bak, nunca excluir na hora - [ ] Novo login e conferência das pastas e mensagens
- [ ] Recriar assinatura e identidades
- [ ] Arquivar o
.bakdepois de alguns dias
Prevenção vale mais que reconstrução. Oriente quem usa muito o catálogo do Roundcube a exportar os contatos periodicamente (o webmail exporta em vCard) e guarde a assinatura do cliente em um documento da agência. Assim a reconstrução deixa de custar retrabalho.
Para explicar ao cliente, uma frase que costuma funcionar: "Seus e-mails estão intactos no servidor. O que corrompeu foi o arquivo de configurações do webmail; vou recriá-lo, e você só vai precisar refazer a assinatura e conferir os contatos salvos no webmail." Ela responde ao medo real (perder mensagens) e antecipa a única perda concreta.
Referências
- Documentação oficial (cpanel) — How to Rebuild the Roundcube Database. Consultado em 2026-10-27.