blog
Painéis

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.

JR · · 6 min de leitura · 2 tabelas · 2 blocos de código

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
  1. O que o erro de banco do Roundcube quer dizer
  2. O que a reconstrução apaga e o que preserva
  3. Três checagens que evitam apagar preferências à toa
  4. Como reconstruir a base do Roundcube no cPanel
  5. Conferir pelo próprio webmail que a caixa voltou
  6. Como padronizar isso em vários sites de clientes

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.

Onde fica cada dadoCaixa de entradaPastas e mensagensPreferências
Dados no servidor IMAP e no arquivo SQLite do Roundcube.

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):

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:

  1. Caixa de entrada lista as mensagens, incluindo as mais antigas. Role até o fim ou use a busca por um remetente conhecido.
  2. 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.
  3. Contagem de não lidas bate com o que o celular ou o cliente de desktop mostra.
  4. Envio funciona: mande uma mensagem de teste para outra caixa e confira se chegou e se ficou em Enviados.
  5. 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.

Fluxo da reconstrução seguraConfirmar se é uma caixa ou o servidorVerificar cota de discoAvisar o cliente e obter o okRenomear o .rcube.db para .bakNovo login e conferência
Sequência para reconstruir sem apagar e-mails.

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:

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

  1. Documentação oficial (cpanel) — How to Rebuild the Roundcube Database. Consultado em 2026-10-27.
Leia também