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.phpY 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:

¡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.
Recibe nuevas publicaciones en tu bandeja de entrada.
No spam. Cancela la suscripción en cualquier momento.