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 linuxRoundcube 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:
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
¿Quieres integrar el plugin de cambio de contraseña ('password') para que los usuarios puedan cambiar su clave de Linux/Postfix desde Roundcube?
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