# 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.

> 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.

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

---

## 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](https://docs.cpanel.net/knowledge-base/email/how-to-rebuild-the-roundcube-database/) 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 `contato@exemplo.com.br` | `/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](https://docs.cpanel.net/knowledge-base/email/how-to-rebuild-the-roundcube-database/) 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.db` da caixa certa
- [ ] Renomear para `.bak`, nunca excluir na hora
- [ ] Novo login e conferência das pastas e mensagens
- [ ] Recriar assinatura e identidades
- [ ] Arquivar o `.bak` depois 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.

