Roundcube Webmail: guia completo de instalação, recursos e personalização

16 out. 2025

Roundcube é um cliente de e-mail baseado em navegador. Ele oferece acesso fácil para gerenciar e-mails por meio de uma interface web.

Roundcube pode ser instalado de duas maneiras: usando Docker Compose ou diretamente em um servidor Ubuntu, para uma abordagem mais prática.

Este guia é um manual completo que cobre tudo, desde pré-requisitos e instalação até solução de problemas e gerenciamento de contas no Roundcube Webmail. Vamos começar pelo porquê.

Por que usar o Roundcube Webmail

Aqui estão alguns dos principais recursos que tornam o Roundcube um cliente de e-mail diferenciado:

Interface amigável: a interface do Roundcube é moderna, simples e fácil de usar.
Suporte a IMAP e SMTP: é compatível com ambos os protocolos, garantindo compatibilidade com a maioria dos servidores de e-mail.
Vários contas de e-mail: os usuários podem configurar várias contas na mesma interface e alternar facilmente entre elas.
Baseado na web: tudo o que você precisa é de um navegador para acessar seus e-mails. Ideal para quem usa vários dispositivos.
Extensível e personalizável: o Roundcube é de código aberto. Com centenas de plugins disponíveis, você pode personalizá-lo ao seu gosto.
Catálogo de endereços: a integração do catálogo permite importar contatos existentes ou criar novos manualmente.

Pré-requisitos

Para seguir este tutorial, você precisará de:

Um servidor Ubuntu: este guia usa o Ubuntu 22.04, mas deve funcionar em outras versões modernas.
Docker e Docker Compose (para o Método 1): se não estiverem instalados, use os comandos abaixo:

sudo apt update
sudo apt install docker docker-compose

Método 1: Configurar o Roundcube com Docker Compose (Recomendado)

Os containers Docker encapsulam todas as dependências necessárias para simplificar o processo de instalação. Veja abaixo um arquivo docker-compose.yml funcional para iniciar o Roundcube Webmail com os plugins thunderbird_labels, show_folder_size e tls_icon.

version: '3'

services:
  roundcubemail:
    image: roundcube/roundcubemail:latest
    container_name: roundcubemail
    volumes:
      - ./www:/var/www/html
      - ./db/sqlite:/var/roundcube/db
    ports:
      - 9002:80
    environment:
      ROUNDCUBEMAIL_DB_TYPE: sqlite
      ROUNDCUBEMAIL_SKIN: elastic
      ROUNDCUBEMAIL_DEFAULT_HOST: "ssl://imap.gmail.com"
      ROUNDCUBEMAIL_SMTP_SERVER: "ssl://smtp.gmail.com"
      ROUNDCUBEMAIL_DEFAULT_PORT: 993
      ROUNDCUBEMAIL_SMTP_PORT: 465
      ROUNDCUBEMAIL_COMPOSER_PLUGINS: "weird-birds/thunderbird_labels,jfcherng-roundcube/show-folder-size,germancoding/tls_icon:^1.2"
      ROUNDCUBEMAIL_PLUGINS: thunderbird_labels, show_folder_size, tls_icon

Explicação das variáveis de ambiente:

ROUNDCUBEMAIL_SKIN: define o tema da interface. “Elastic” é o tema moderno e “Classic” é o mais simples.
ROUNDCUBEMAIL_DEFAULT_HOST: servidor IMAP padrão ao qual o Roundcube se conectará.
ROUNDCUBEMAIL_DEFAULT_PORT: número da porta IMAP.
ROUNDCUBEMAIL_SMTP_SERVER: servidor SMTP usado para envio de e-mails.
ROUNDCUBE_SMTP_PORT: número da porta SMTP.
ROUNDCUBEMAIL_COMPOSER_PLUGINS: complementos que aprimoram a experiência e as funcionalidades.
ROUNDCUBEMAIL_PLUGINS: ativa os plugins instalados pela variável anterior.

Seu provedor de e-mail fornecerá as informações sobre servidor IMAP, porta IMAP, servidor SMTP e configurações de SMTP. Ajuste essas variáveis conforme seu provedor e o tipo de criptografia (SSL/TLS).

Para implantar este arquivo docker-compose, verifique se o Docker e o Docker Compose estão instalados:

docker --version && docker-compose --version

Inicie o serviço Docker:

systemctl start docker

Implante o arquivo:

docker-compose up

Pode levar de 2 a 3 minutos para que o Roundcube fique totalmente funcional em <O-IP-do-seu-servidor>:9092. Para começar a gerenciar seus e-mails, insira as credenciais fornecidas pelo seu provedor de e-mail.

Se você estiver usando Gmail ou Outlook, o nome de usuário será seu endereço de e-mail completo (@gmail ou @outlook).

Após o login, você verá uma interface semelhante.

Método 2: Instalação direta no servidor Ubuntu

O Roundcube é uma aplicação LAMP escrita em PHP e compatível com vários bancos de dados, incluindo MySQL, PostgreSQL e SQLite.

Passo 1: Instalar PHP e Apache

Antes da instalação, atualize a lista de pacotes:

sudo apt update
sudo apt install php apache2

Também é necessário instalar e habilitar algumas extensões PHP:

sudo apt install php-mbstring php-xml php-imap php-sqlite3 php-json php-curl php-zip php-gd php-intl

Função de cada extensão:

php-mbstring: suporte a codificações multibyte
php-xml: suporte a documentos XML
php-imap: permite conexão com servidores IMAP
php-sqlite3: adaptador PHP para SQLite
php-json: codificação e decodificação JSON
php-curl: permite enviar requisições HTTP
php-zip: leitura e escrita de arquivos ZIP
php-gd: manipulação de imagens
php-intl: suporte a idiomas e configurações regionais

Passo 2: Baixar o código-fonte do Roundcube

Baixe o código-fonte em https://roundcube.net/download/. Escolha a versão completa e estável para facilitar a implantação.

Baixe o aplicativo no diretório /var/www:

cd /var/www
sudo wget https://github.com/roundcube/roundcubemail/releases/download/1.6.10/roundcubemail-1.6.10-complete.tar.gz

Passo 3: Extrair e definir permissões

Uma maneira simples de permitir que o Apache leia e escreva no diretório raiz é alterar a propriedade para o usuário www-data:

sudo tar xvf roundcubemail-1.6.10-complete.tar.gz
sudo chown -R www-data:www-data roundcube-1.6.10
cd roundcube-1.6.10

Passo 4: Configurar o arquivo de configuração

O arquivo de configuração determina quais plugins serão usados, qual tema será aplicado e quais servidores SMTP e IMAP serão utilizados.

Crie uma cópia do arquivo de configuração padrão (verifique se você está em /var/www/roundcube-1.6.10) e edite-o:

sudo cp config/config.inc.php.sample config/config.inc.php

sudo nano config.inc.php

Exemplo de configuração para o servidor Outlook. Ajuste db_dsnw, imap_host e smtp_host conforme o seu provedor. Esta configuração usa um banco SQLite por simplicidade:

$config[‘db_dsnw’] = ‘sqlite:////var/www/roundcubemail-1.6.10/config/db.sqlite?mode=0640’;
$config[‘imap_host’] = ‘ssl://imap.office365.com:993’;
$config[‘smtp_host’] = ‘ssl://smtp-mail.outlook.com:587’;

Para usar alguns plugins, baixe-os manualmente na pasta plugins ou use o Composer para gerenciá-los e depois ative-os no arquivo de configuração.

Passo 5: Configurar o Apache

Crie um novo arquivo roundcube_site.conf em /etc/apache2/sites-available com o seguinte conteúdo:

<VirtualHost *:80>
    DocumentRoot /var/www/roundcubemail-1.6.10
    # ServerName roundcube.CHANGEME_YOURDOMAIN.com  # Substitua pelo seu domínio

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

    <Directory /var/www/roundcubemail-1.6.10>
        AllowOverride All
        Require all granted
    </Directory>

   # Bloqueia o acesso ao banco de dados
   <FilesMatch "\.sqlite$">
    Require all denied
   </FilesMatch>

</VirtualHost>

Ative o novo site do Apache:

sudo a2ensite roundcube_site.conf

Desative o site padrão para evitar conflitos:

sudo a2dissite 000_default.conf

Recarregue o Apache para aplicar as alterações:

sudo systemctl reload apache2

Passo 6: Iniciar e instalar

Acesse a interface do Roundcube visitando o IP do seu servidor. Será solicitado o nome de usuário e a senha, obtidos junto ao seu provedor de e-mail.

Solução de problemas

Se a instalação não funcionar corretamente, verifique o arquivo errors.log.

Também é possível verificar os logs do Apache para mais informações:

tail -f /var/log/apache2/access.log
tail -f /var/log/apache2/error.log

Gerenciamento de múltiplas contas

Para adicionar mais contas, vá até Configurações > Identidades > Criar.

Importar contatos

Você pode importar seus contatos anteriores a partir de um arquivo vCard ou CSV acessando a aba Contatos e clicando em Importar no topo.

Se quiser importar CardDAV, adicione o plugin roundcube/carddav.

Os Destinatários coletados exibirão uma lista de contatos já utilizados. Da mesma forma, os Remetentes confiáveis mostrarão uma lista de remetentes conhecidos.

Plugins úteis do Roundcube

Alguns dos plugins mais populares incluem:

Larry: o tema Larry.
Contextmenu: adiciona menus de clique direito na interface.
Gravatar: exibe imagens do Gravatar para e-mails.
Identity_switch: permite alternar entre identidades de usuário.
Advanced Search: busca rápida em e-mails.
Sauserprefs: ajuda a combater spam.
Calendar: integração de calendário.
Roundcube_caldav: CalDAV permite gerenciar eventos em calendários como o Google Calendar, essencial para colaboração em equipe.
Identity SMTP : configurações SMTP diferentes por identidade.
Carddav: método padrão para armazenar e importar contatos no formato vCard.
Customizr: permite personalizar logotipos e estilos.
Fail2ban: exibe o número de tentativas de acesso falhadas.
Html5_notifier: envia notificações de desktop para novas atividades de e-mail.
Thunderbird_labels: adiciona etiquetas aos e-mails.

Alternativas ao Roundcube

Se você não gostar da experiência com o Roundcube, considere outras opções:

Horde Webmail: suíte integrada com e-mail, calendário e gerenciamento de tarefas. Ideal para equipes.
Zimbra Webmail: disponível em versões open source e comercial, conhecido pela segurança e autenticação em dois fatores.
Rainloop: design moderno e limpo, não requer banco de dados e é fácil de configurar.

Roundcube Webmail: é a escolha certa para você?

O Roundcube oferece centenas de plugins para personalização. Com a implantação via Docker, ele pode ser configurado em poucos minutos.

Se você tem experiência com administração de servidores e busca uma solução de webmail leve e de código aberto, o Roundcube é ideal. Caso precise de recursos avançados ou prefira evitar o auto-hospedagem, considere outras opções.

Roundcube Webmail: guia completo de instalação, recursos e personalização

Por que usar o Roundcube Webmail Copiar link

Pré-requisitos Copiar link

Método 1: Configurar o Roundcube com Docker Compose (Recomendado) Copiar link

Método 2: Instalação direta no servidor Ubuntu Copiar link

Passo 1: Instalar PHP e Apache Copiar link

Passo 2: Baixar o código-fonte do Roundcube Copiar link

Passo 3: Extrair e definir permissões Copiar link

Passo 4: Configurar o arquivo de configuração Copiar link

Passo 5: Configurar o Apache Copiar link

Passo 6: Iniciar e instalar Copiar link

Solução de problemas Copiar link

Gerenciamento de múltiplas contas Copiar link

Importar contatos Copiar link

Plugins úteis do Roundcube Copiar link

Alternativas ao Roundcube Copiar link

Roundcube Webmail: é a escolha certa para você? Copiar link

Por que usar o Roundcube Webmail

Pré-requisitos

Método 1: Configurar o Roundcube com Docker Compose (Recomendado)

Método 2: Instalação direta no servidor Ubuntu

Passo 1: Instalar PHP e Apache

Passo 2: Baixar o código-fonte do Roundcube

Passo 3: Extrair e definir permissões

Passo 4: Configurar o arquivo de configuração

Passo 5: Configurar o Apache

Passo 6: Iniciar e instalar

Solução de problemas

Gerenciamento de múltiplas contas

Importar contatos

Plugins úteis do Roundcube

Alternativas ao Roundcube

Roundcube Webmail: é a escolha certa para você?