ISPConfig · 2 min read · Oct 04, 2025

Instalar ISPConfig 3 - complementos de Roundcube en Debian 10

Los complementos ispconfig3_roundcube integran la configuración de tu cuenta de correo ISPConfig en Roundcube. En este tutorial, te guiaré a través del proceso de instalación.

Prerrequisitos

  • Roundcube debe estar instalado usando apt. Si no, es posible que debas cambiar las rutas de archivo utilizadas en este tutorial.
  • Asegúrate de que tu instalación de ISPConfig y Roundcube esté actualizada.

Agregar un usuario remoto

Los complementos de ISPConfig 3 utilizan la API para conectarse a tu sistema. Por lo tanto, necesitamos crear un usuario remoto en el panel de control.

Inicia sesión en tu panel, ve a Sistema -> Usuarios Remotos, y haz clic en “Agregar nuevo usuario remoto”. En el formulario, dale a tu nuevo usuario un nombre y una contraseña. Usaré rc-example con la contraseña examplepass. No uses las mismas credenciales, sino crea las tuyas. Mi panel de ejemplo estará ubicado en https://panel.example.com:8080 con un certificado SSL válido.

Habilita la siguiente función para tu usuario remoto:

  • Funciones de complementos de Roundcube

Y habilita el acceso remoto para la dirección IPv4 e IPv6 de tu servidor de webmail.

Descargar los complementos

Ejecuta los siguientes comandos:

cd /tmp  
wget https://github.com/w2c/ispconfig3_roundcube/archive/master.zip  
unzip master.zip  
cd ./ispconfig3_roundcube-master  
cp -r ./ispconfig3_* /usr/share/roundcube/plugins  
ln -s /usr/share/roundcube/plugins/ispconfig* /var/lib/roundcube/plugins/

Los complementos ahora están en la carpeta correcta, con un enlace simbólico desde /var/lib/roundcube/plugins. El siguiente paso es configurarlos para usar nuestro usuario remoto. Ejecuta esto para copiar la configuración de ejemplo y editarla:

cp /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php.dist /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php
nano /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php

Verás este archivo de configuración:

$config['identity_limit'] = false;
$config['remote_soap_user'] = '{REMOTE USERNAME}';
$config['remote_soap_pass'] = '{REMOTE PASSWORD}';
$config['soap_url'] = 'https://{YOUR SERVER}:8080/remote/';
$config['soap_validate_cert'] = true;

Cambiaré esto a:

$config['identity_limit'] = false;
$config['remote_soap_user'] = 'rc-example';
$config['remote_soap_pass'] = 'examplepass';
$config['soap_url'] = 'https://panel.example.com:8080/remote/';
$config['soap_validate_cert'] = true;

Asegúrate de reemplazar el texto subrayado en rojo con tus propias credenciales y la dirección de tu panel. Cambia soap_validate_cert a false si usas https pero no tienes un certificado SSL de confianza instalado.

Habilitar los complementos

Para habilitar los complementos, abre la configuración de roundcube:

nano /etc/roundcube/config.inc.php

Y busca estas líneas:

// Lista de complementos activos (en el directorio plugins/) $config['plugins'] = array();

Para habilitar los complementos, agrega esto entre los corchetes:

"jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist"

La línea se verá así:

// Lista de complementos activos (en el directorio plugins/) $config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist");

Algunas notas sobre esto:

  • El complemento jqueryui debe colocarse delante de los otros complementos.
  • Si no deseas usar un complemento, por ejemplo, el complemento fetchmail, omite ispconfig3_fetchmail.
  • Si usas más de un servidor de correo, agrega ispconfig3_autoselect a la lista y deja $config['default_host'] vacío. ispconfig3_autoselect seleccionará automáticamente el servidor correcto para el usuario que inicia sesión. Puedes editar su propio archivo de configuración para habilitar conexiones tls/ssl entre Roundcube y el servidor de correo externo en ispconfig3_autoselect/config/config.inc.php.dist.

Después de guardar el archivo de configuración, aparecerá una nueva pestaña “Cuenta” en la configuración de webmail:

Nueva pestaña de configuración

¡Hemos terminado!

Si experimentas algún problema, consulta la sección de preguntas frecuentes sobre solución de problemas en https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ

Si tienes alguna pregunta o comentario, puedes dejarlos en las respuestas o crear una publicación en el foro.

Share: X/Twitter LinkedIn

Recibe nuevas publicaciones en tu bandeja de entrada.

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