Roundcube

Acessar o Roundcube

• Abra o seguinte URL no seu browser: https://<SERVER_IP>
• A instalação usa um certificado TLS autoassinado, então seu navegador exibirá um aviso de segurança. Aceite o certificado para continuar.
• As solicitações HTTP na porta 80 são redirecionadas automaticamente para HTTPS.

Login

• O Roundcube não cria nem armazena contas de caixa postal.
• Faça login com o usuário e a senha de uma caixa postal existente no servidor IMAP configurado.

Configure seu servidor de e-mail

As configurações de conexão com o servidor de e-mail ficam em: /root/roundcube/.env

Configurações importantes:

• Host IMAP: IMAP_HOST
• Porta IMAP: IMAP_PORT
• Host SMTP: SMTP_HOST
• Porta SMTP: SMTP_PORT
• Domínio do nome de usuário: USERNAME_DOMAIN

A configuração padrão usa valores de exemplo:

IMAP_HOST=ssl://mail.example.org
IMAP_PORT=993

SMTP_HOST=tls://mail.example.org
SMTP_PORT=587

Substitua-os pelo nome de host real do seu servidor de e-mail.

Depois de alterar as configurações, aplique-as com:

cd /root/roundcube && docker compose up -d

Tipos de conexão TLS

Use o prefixo adequado para o seu servidor de e-mail:

• ssl://: Implicit TLS, typically used with IMAP port 993 or SMTP port 465.
• tls://: STARTTLS, typically used with IMAP port 143 or SMTP port 587.

Certificados autoassinados do servidor de e-mail

Se o seu servidor IMAP ou SMTP usa um certificado autoassinado, o Roundcube pode recusar a conexão.

As configurações opcionais de verificação TLS ficam em: /root/roundcube/config/custom.inc.php

Descomente e configure as opções de conexão IMAP ou SMTP correspondentes apenas se você confiar no servidor de e-mail e na rede.

Aplique a configuração:

cd /root/roundcube && docker compose restart roundcube

Plugins e skin

A instalação padrão ativa:

• archive
• zipdownload

Plugins are configured through the PLUGINS variable in: /root/roundcube/.env

Por exemplo:

PLUGINS=archive,zipdownload,managesieve

Aplique as alterações:

cd /root/roundcube && docker compose up -d

Bundled plugins such as managesieve, markasjunk, e enigma can be enabled by adding them to PLUGINS, when supported by the image.

For third-party plugins, add them to ROUNDCUBEMAIL_COMPOSER_PLUGINS in the Compose file and include their names in PLUGINS.

Gerenciar o Roundcube

Ver o status dos contêineres:

cd /root/roundcube && docker compose ps

Ver registos:

cd /root/roundcube && docker compose logs -f

Reiniciar o Roundcube:

cd /root/roundcube && docker compose restart roundcube

Parar o stack:

cd /root/roundcube && docker compose down

Iniciar o stack:

cd /root/roundcube && docker compose up -d

Ficheiros e diretórios importantes

• Caminho de instalação: /root/roundcube
• Arquivo Compose: /root/roundcube/docker-compose.yml
• Arquivo de ambiente: /root/roundcube/.env
• Configuração adicional: /root/roundcube/config/custom.inc.php
• Volume do banco de dados: /var/lib/docker/volumes/roundcube_db_data
• Configuração do Nginx: /etc/nginx/sites-available/roundcube
• Certificado TLS: /etc/nginx/ssl/roundcube.crt
• Chave privada TLS: /etc/nginx/ssl/roundcube.key

Domínio e HTTPS

1. Point your domain to the server's IP address (e.g., yourdomain.com;).

2. Instale o Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. Edit NGINX config and replace both server_name _; entries with your domain (e.g., server_name yourdomain.com;):

vim /etc/nginx/sites-available/roundcube

4. Emita um certificado TLS:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Edite /etc/nginx/sites-available/roundcube e atualize as ssl_certificate e ssl_certificate_key diretivas para usar o seu certificado Let's Encrypt.

Before:
    ssl_certificate     /etc/nginx/ssl/roundcube.crt;
    ssl_certificate_key /etc/nginx/ssl/roundcube.key;
After:
    ssl_certificate  /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Teste a configuração:

nginx -t

7. Recarregue o NGINX:

systemctl reload nginx

8. Abra o navegador e acesse: https://yourdomain.com

Notas

• Roundcube is publicly accessible through Nginx on ports 80 e 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• O MariaDB é um serviço interno do Docker e não é exposto diretamente ao host.
• A interface web padrão usa um certificado TLS autoassinado.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Ajuste a configuração do Roundcube conforme sua preferência.