Webmail Setup · 5 min read · Jan 14, 2026

Uso de RoundCube Webmail con ISPConfig 3 en Debian Wheezy (Apache2)

Esta guía explica cómo instalar la aplicación de webmail RoundCube en un servidor Debian Wheezy que ejecuta ISPConfig y Apache2, y cómo habilitar los complementos de ISPConfig 3 para RoundCube para que los usuarios puedan realizar acciones como cambiar sus contraseñas de correo electrónico desde RoundCube. Roundcube webmail es un cliente IMAP multilingüe basado en navegador con una interfaz de usuario similar a una aplicación; viene con funciones como soporte MIME, libreta de direcciones, manipulación de carpetas, búsqueda de mensajes y verificación ortográfica.

¡No emito ninguna garantía de que esto funcione para ti!

1 Nota Preliminar

Este tutorial asume que estás utilizando Apache2 como el servidor web en tu servidor ISPConfig 3; este tutorial no funcionará para nginx. Voy a instalar RoundCube desde los repositorios de Debian Wheezy - es una versión razonablemente reciente (0.7.2.9 vs 0.9.1 (versión estable actual)).

RoundCube se configurará de tal manera que se pueda acceder desde cada vhost a través del alias /webmail (por ejemplo, http://www.example.com/webmail).

Si ya estás utilizando otra aplicación de webmail como SquirrelMail, asegúrate de desactivarla completamente o al menos el alias /webmail. Si has instalado SquirrelMail como un paquete de Debian, puedes encontrar el alias en /etc/apache2/conf.d/squirrelmail.conf; comenta el alias para desactivar solo el alias /webmail o comenta todo el archivo para desactivar SquirrelMail completamente. No olvides reiniciar Apache después.

2 Creando un Usuario Remoto en ISPConfig

Los complementos de ISPConfig 3 para RoundCube funcionan a través de la API remota de ISPConfig. Para usar esta API, necesitamos un usuario remoto. Para crear dicho usuario, ve a Sistema > Gestión de Usuarios > Usuarios Remotos y haz clic en el botón Agregar nuevo usuario:

Proporciona un nombre de usuario y una contraseña para el usuario…

… y habilita las siguientes funciones:

  • Funciones del servidor
  • Funciones del cliente
  • Funciones del usuario de correo
  • Funciones del alias de correo
  • Funciones del usuario del filtro de spam de correo
  • Funciones de política del filtro de spam de correo
  • Funciones de fetchmail de correo
  • Funciones de lista blanca del filtro de spam de correo
  • Funciones de lista negra del filtro de spam de correo
  • Funciones del filtro de usuario de correo

Luego haz clic en Guardar.

3 Instalando RoundCube

Podemos instalar RoundCube de la siguiente manera:

apt-get install roundcube roundcube-plugins roundcube-plugins-extra

Verás las siguientes preguntas:

¿Configurar la base de datos para roundcube con dbconfig-common? <– Sí
Tipo de base de datos a utilizar por roundcube: <– mysql
Contraseña del usuario administrativo de la base de datos: <– tucontraseñadeusuarioSQLroot (la contraseña del usuario root de MySQL)
Contraseña de la aplicación MySQL para roundcube: <– contraseñaderoundcube
Confirmación de contraseña: <– contraseñaderoundcube

Esto creará una base de datos MySQL llamada roundcube con el usuario MySQL roundcube y la contraseña contraseñaderoundcube.

A continuación, abre /etc/apache2/conf.d/roundcube…

vi /etc/apache2/conf.d/roundcube

… y agrega la línea Alias /webmail /var/lib/roundcube. Además de eso, agrega la configuración de PHP a la sección (he resaltado los cambios):

| # Estos alias no funcionan correctamente con varios hosts en tu servidor apache # Descoméntalos para usarlos o adáptalos a tu configuración Alias /roundcube/program/js/tiny_mce/ /usr/share/tinymce/www/ Alias /roundcube /var/lib/roundcube Alias /webmail /var/lib/roundcube # Acceso a archivos de tinymce Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny allow from all Options +FollowSymLinks DirectoryIndex index.php AddType application/x-httpd-php .php php_flag magic_quotes_gpc Off php_flag track_vars On php_flag register_globals Off php_value include_path .:/usr/share/php # Esto es necesario para analizar /var/lib/roundcube/.htaccess. Consulta su # contenido antes de establecer AllowOverride en None. AllowOverride All order allow,deny allow from all # Protegiendo directorios básicos: Options -FollowSymLinks AllowOverride None Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all |

Reinicia Apache después:

/etc/init.d/apache2 restart

4 Configurando RoundCube

Abre /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… y establece $rcmail_config[‘default_host’] = ‘localhost’; (o el nombre de host o dirección IP de tu servidor de correo si está en una máquina remota):

| [...] $rcmail_config['default_host'] = 'localhost'; [...] |

De lo contrario, RoundCube pedirá un nombre de host antes de cada inicio de sesión, lo que podría sobrecargar a tus usuarios; queremos hacer que el uso sea lo más fácil posible.

A continuación, instala los complementos de ISPConfig 3 para RoundCube:

cd /tmp  
git clone https://github.com/w2c/ispconfig3_roundcube.git  
cd /tmp/ispconfig3_roundcube/  
mv ispconfig3_* /var/lib/roundcube/plugins  
cd /var/lib/roundcube/plugins  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php

Abre ispconfig3_account/config/config.inc.php…

vi ispconfig3_account/config/config.inc.php

… y completa los detalles de inicio de sesión de tu usuario remoto de ISPConfig y la URL de la API remota - mi instalación de ISPConfig se ejecuta en https://192.168.0.100:8080, así que la URL de la API remota es https://192.168.0.100:8080/remote/:

| |

Finalmente, abre /etc/roundcube/main.inc.php nuevamente…

vi /etc/roundcube/main.inc.php

… y habilita el complemento jquerui más los complementos de ISPConfig 3…

| [...] // ---------------------------------- // PLUGINS // ---------------------------------- // Lista de complementos activos (en el directorio plugins/) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… y cambia la apariencia de predeterminada a clásica (de lo contrario, los complementos de ISPConfig 3 no funcionarán):

| [...] // nombre de la apariencia: carpeta de skins/ $rcmail_config['skin'] = 'classic'; [...] |

Eso es todo; ahora puedes acceder a RoundCube bajo el alias /webmail (por ejemplo, www.example.com/webmail). Inicia sesión con la dirección de correo electrónico y la contraseña de una cuenta de correo electrónico creada a través de ISPConfig:

Así es como se ve RoundCube:

En Configuración > Cuenta puedes usar los complementos de ISPConfig 3 para RoundCube para modificar tu configuración, por ejemplo…

… puedes establecer una nueva contraseña para tu cuenta de correo electrónico sin usar ISPConfig:

5 Enlaces

Share: X/Twitter LinkedIn
#Webmail Setup

Recibe nuevas publicaciones en tu bandeja de entrada.

No spam. Cancela la suscripción en cualquier momento.