Esta guía explica cómo desplegar n8n utilizando su imagen Docker oficial en la plataforma Jelastic Cloud (PaaS Infomaniak).

Prólogo

• A diferencia de herramientas como Zapier o Make, n8n, herramienta de automatización de flujo de trabajo “fair-code”, puede ser auto-hospedada, lo que le permite mantener un control total sobre sus datos mientras conecta cientos de servicios a través de una interfaz visual intuitiva.
• La imagen oficial utilizada es n8nio/n8n.
• El uso de una base de datos externa (PostgreSQL) se recomienda encarecidamente para la estabilidad y la gestión de grandes volúmenes de datos.
• El puerto interno predeterminado es el 5678.
• Si es necesario, socios locales y referenciados por Infomaniak pueden encargarse de estos trámites: lance una solicitud de oferta gratuita; ellos se encargan de todo, liberándolo de los detalles técnicos — también descubra el papel del proveedor de alojamiento.

1. Creación del entorno Jelastic

Proceda de la siguiente manera para configurar su topología:

1. Inicie sesión en el panel de control de Jelastic Cloud.
2. Haga clic en Nuevo entorno.
3. En el asistente de creación:
   • Vaya a la pestaña Docker.
   • Haga clic en Seleccionar una imagen y busque n8nio/n8n. Fije una versión (por ejemplo, latest o una versión específica como 1.75.0).
   • Load Balancer: agregue un nodo (por ejemplo, Nginx) para gestionar el SSL y el acceso público.
   • Base de datos: agregue un nodo PostgreSQL (se recomienda la versión 14+).
4. Asigne suficientes Cloudlets (se recomiendan 8 min. para n8n en pico) y nombre su entorno.
5. Haga clic en Crear.

2. Configuración del almacenamiento y la persistencia

Por defecto, los datos de Docker son efímeros. Es imperativo montar un volumen:

1. En el nodo n8n, haga clic en el ícono Configuración (el engranaje).
2. Vaya a la sección Volúmenes.
3. Haga clic en Agregar:
   • Ruta local: /home/node/.n8n
4. Guarde; los archivos de configuración y el cifrado local se preservarán a partir de ahora.

3. Variables de entorno esenciales

Acceda a la sección Variables de entorno del contenedor n8n para definir los siguientes parámetros:

Conexión con PostgreSQL

Para usar la base de datos externa, también agregue:

• DB_TYPE: postgresdb
• DB_POSTGRESDB_HOST: Dirección IP interna o DNS del nodo Postgres.
• DB_POSTGRESDB_PORT: 5432
• DB_POSTGRESDB_DATABASE: Nombre de la base (por ejemplo: n8n).
• DB_POSTGRESDB_USER: Su usuario.
• DB_POSTGRESDB_PASSWORD: Su contraseña.

4. Primer acceso y seguridad

1. Una vez que el contenedor se haya reiniciado, abra la URL de su entorno.
2. Creación de la cuenta: n8n le pedirá que cree la primera cuenta de administrador.
3. SSL: si usa un dominio personalizado, instale el complemento Let's Encrypt en el nodo Load Balancer.

5. Verificación post-instalación

• Cree un flujo de trabajo de prueba con un nodo Webhook y verifica que la URL generada esté en https.
• Verifica en los registros del contenedor que no aparezca ningún error de conexión a la base de datos.