Cómo instalar y configurar RoundCube en linux

 Le preguntamos a Gemini, la inteligencia artificial de Google, cómo instalar y configurar RoundCube en linux

Explicanos detalladamente cómo instalar y configurar RoundCube en linux

Roundcube es el cliente de correo Webmail de código abierto más popular, ligero y moderno. A diferencia de suites complejas como Open-Xchange, Roundcube no administra cuentas ni almacena correos por sí mismo: actúa como una interfaz web ligera que habla directamente con tu servidor IMAP (Dovecot) para leer/organizar mensajes y con SMTP (Postfix) para enviarlos.

Para este despliegue, asumiremos un entorno Linux estándar (Ubuntu/Debian o RHEL/Rocky Linux) con Nginx/Apache, PHP (8.x) y MariaDB.

Requisitos Previos de PHP

Roundcube requiere varias extensiones de PHP instaladas para procesar caracteres, adjuntos, base de datos y cifrado:

Bash

# En Ubuntu / Debian

sudo apt update

sudo apt install php-fpm php-mysql php-xml php-mbstring php-intl php-zip php-gd php-curl php-imagick -y

# En RHEL / Rocky Linux / AlmaLinux

sudo dnf install php php-fpm php-mysqlnd php-xml php-mbstring php-intl php-zip php-gd php-json -y

1.1. Configurar MariaDB / MySQL:

Crear la base de datos y usuario dedicado.

Roundcube almacena allí la libreta de direcciones, identidades, preferencias de usuario y sesiones (no los correos electrónicos).

Accede a MariaDB como root:

Bash

sudo mariadb -u root -p

Ejecuta los siguientes comandos SQL:

SQLCREATE DATABASE roundcubemail CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'roundcube'@'localhost' IDENTIFIED BY 'TuClaveSegura123!';

GRANT ALL PRIVILEGES ON roundcubemail.* TO 'roundcube'@'localhost';

FLUSH PRIVILEGES;

EXIT;

2.2. Descargar e instalar Roundcube:

Descarga del paquete oficial Complete.

Descargamos la edición Complete (incluye dependencias de Composer precompiladas) desde el repositorio oficial.

Bash

cd /tmp

# Descargar la versión LTS actual

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

# Extraer y mover a la ruta web estándar

tar -xzvf roundcubemail-*-complete.tar.gz

sudo mv roundcubemail-* /var/www/roundcube

3.3. Importar esquema SQL y permisos:

Asignación de permisos al servidor web.

Cargamos las tablas iniciales en MariaDB y ajustamos la propiedad del directorio al usuario del servidor web (www-data en Debian/Ubuntu, nginx o apache en RHEL).

Importar esquema de base de datos:

Bash

sudo mariadb -u roundcube -pTuClaveSegura123! roundcubemail < /var/www/roundcube/SQL/mysql.initial.sql

Ajustar permisos de archivos:

Bash

# En Debian/Ubuntu:

sudo chown -R www-data:www-data /var/www/roundcube

# En RHEL/Rocky (usando apache/nginx):

# sudo chown -R nginx:nginx /var/www/roundcube

sudo chmod -R 755 /var/www/roundcube

sudo chmod -R 777 /var/www/roundcube/temp /var/www/roundcube/logs

4.4. Configurar el archivo principal (config.inc.php):

Conexión IMAP, SMTP y llaves de cifrado.

Crea el archivo de configuración copiando la plantilla predeterminada:

Bash

sudo cp /var/www/roundcube/config/config.inc.php.sample /var/www/roundcube/config/config.inc.php

sudo nano /var/www/roundcube/config/config.inc.php

Edita o establece las siguientes variables esenciales:

PHP

5.5. Configurar el Servidor Web:

VirtualHost para Nginx o Apache.

Ejemplo para Nginx con PHP-FPM:

Crea el archivo /etc/nginx/sites-available/roundcube:

Nginx

server {

       listen 80;

       server_name webmail.tudominio.com;

       root /var/www/roundcube;

       index index.php index.html;



       # Ocultar archivos sensibles

        location ~ ^/(config|temp|logs|build|SQL|bin)/ {

                deny all;

        }



        location ~ \.php$ {

                include snippets/fastcgi-php.conf;

                fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # Ajusta a tu versión de PHP

         }



          location ~ /\. {

                 deny all;

          }

}

Activa el sitio y recarga Nginx:

Bash

sudo ln -s /etc/nginx/sites-available/roundcube /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl reload nginx

6.6. Eliminar el instalador por seguridad:

Bloqueo de seguridad.

Si usaste el asistente web en navegador

([http://webmail.tudominio.com/installer]

(http://webmail.tudominio.com/installer)), o para evitar ataques de reinstalación, borra inmediatamente el directorio installer:

Bash

sudo rm -rf /var/www/roundcube/installer

Verificación y Solución de Errores Comunes

Error / Síntoma	Causa Frecuente	Solución
"DATABASE ERROR: CONNECTION FAILED"	Credenciales erróneas o MariaDB no escucha en socket local.	Verifica config['db_dsn'] en config.inc.php y prueba conectarte manualmente con mysql -u roundcube -p.
"Connection to storage server failed"	Roundcube no puede conectar a Dovecot (IMAP).	Verifica si Dovecot está corriendo (systemctl status dovecot) y escuchando en el puerto 143/993 (ss -tlpn | grep 143).
"SMTP Error (-1): Connection failed"	Postfix está bloqueado o rechaza la IP local.	Asegúrate de que 127.0.0.1 esté en mynetworks en /etc/postfix/main.cf o que el puerto 25/587 responda.
Archivos adjuntos fallan al subir	Límite de carga de PHP muy bajo.	Eleva upload_max_filesize y post_max_size en /etc/php/8.x/fpm/php.ini (ej. 25M).

¿Quieres integrar el plugin de cambio de contraseña ('password') para que los usuarios puedan cambiar su clave de Linux/Postfix desde Roundcube?