Roundcube

Acceder a Roundcube

• Abre la siguiente URL en tu navegador: https://<SERVER_IP>
• La instalación usa un certificado TLS autofirmado, por lo que tu navegador mostrará una advertencia de seguridad. Acepta el certificado para continuar.
• Las solicitudes HTTP en el puerto 80 se redirigen automáticamente a HTTPS.

Inicio de sesión

• Roundcube no crea ni almacena cuentas de correo.
• Inicia sesión con el usuario y la contraseña de un buzón existente en el servidor IMAP configurado.

Configura tu servidor de correo

Los ajustes de conexión al servidor de correo se guardan en: /root/roundcube/.env

Ajustes importantes:

• Host IMAP: IMAP_HOST
• Puerto IMAP: IMAP_PORT
• Host SMTP: SMTP_HOST
• Puerto SMTP: SMTP_PORT
• Dominio del nombre de usuario: USERNAME_DOMAIN

La configuración predeterminada usa valores de ejemplo:

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

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

Sustitúyelos por el nombre de host real de tu servidor de correo.

Tras cambiar los ajustes, aplícalos con:

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

Tipos de conexión TLS

Usa el prefijo adecuado para tu servidor de correo:

• 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 autofirmados del servidor de correo

Si tu servidor IMAP o SMTP usa un certificado autofirmado, Roundcube puede rechazar la conexión.

Los ajustes opcionales de verificación TLS están en: /root/roundcube/config/custom.inc.php

Descomenta y configura las opciones de conexión IMAP o SMTP correspondientes solo si confías en el servidor de correo y en la red.

Aplica la configuración:

cd /root/roundcube && docker compose restart roundcube

Plugins y skin

La instalación predeterminada activa:

• archive
• zipdownload

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

Por ejemplo:

PLUGINS=archive,zipdownload,managesieve

Aplica los cambios:

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

Bundled plugins such as managesieve, markasjunk, y 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.

Gestionar Roundcube

Ver el estado de los contenedores:

cd /root/roundcube && docker compose ps

Ver registros:

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

Reiniciar Roundcube:

cd /root/roundcube && docker compose restart roundcube

Detener el stack:

cd /root/roundcube && docker compose down

Iniciar el stack:

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

Archivos y directorios importantes

• Ruta de instalación: /root/roundcube
• Archivo Compose: /root/roundcube/docker-compose.yml
• Archivo de entorno: /root/roundcube/.env
• Configuración adicional: /root/roundcube/config/custom.inc.php
• Volumen de la base de datos: /var/lib/docker/volumes/roundcube_db_data
• Configuración de Nginx: /etc/nginx/sites-available/roundcube
• Certificado TLS: /etc/nginx/ssl/roundcube.crt
• Clave privada TLS: /etc/nginx/ssl/roundcube.key

Dominio y HTTPS

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

2. Instala 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. Emite un certificado TLS:

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

5. Edita /etc/nginx/sites-available/roundcube y actualiza las ssl_certificate y ssl_certificate_key directivas para que usen tu certificado de 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. Comprueba la configuración:

nginx -t

7. Recarga NGINX:

systemctl reload nginx

8. Abre tu navegador y visita: https://yourdomain.com

Notas

• Roundcube is publicly accessible through Nginx on ports 80 y 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB es un servicio interno de Docker y no se expone directamente al host.
• La interfaz web predeterminada usa un certificado TLS autofirmado.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Ajusta la configuración de Roundcube según tus preferencias.