n8n

¿Qué permite hacer?

ArduMaker instala n8n como un stack de Docker listo para producción: un proceso principal, workers en modo cola, un task runner por proceso, su propio PostgreSQL y su propio Redis. Es una instalación por VPS.

• Instalar sin preguntas: las credenciales internas se generan solas.
• Publicar el editor con HTTPS; la URL de webhooks y del editor se configura sola.
• Reiniciar, actualizar de versión (con copia de la base antes) y escalar workers.
• Editar variables de entorno desde el panel, con las críticas protegidas.
• Desinstalar conservando los datos, o borrándolos con confirmación.

¿Cuándo conviene usarlo?

• Automatizaciones y webhooks propios, sin límites de ejecuciones de un servicio alojado.
• Flujos con nodos Code que necesitan aislamiento real (task runners externos).
• Mucho volumen de ejecuciones que conviene repartir entre workers.

¿Cómo funciona en ArduMaker?

1. Validar: VPS activo, función n8n del sistema, Docker posible y RAM libre real (MemAvailable) de al menos 4 GB. Si ya hay un n8n (Docker o npm), se adopta tal cual, sin reinstalar ni migrar.
2. Preparar credenciales (o reutilizar las del .env de un intento anterior: un PostgreSQL ya inicializado no acepta otra contraseña).
3. Generar el Compose desde código según la RAM libre, bajar las imágenes como paso largo y levantar el stack.
4. Publicar el editor (puerto 5678) con HTTPS y escribir en el .env WEBHOOK_URL y N8N_EDITOR_BASE_URL con la dirección publicada, y N8N_PROXY_HOPS=1.
5. Verificar: running solo con el proceso principal activo, /healthz y /healthz/readiness en 200 y todos los workers activos.

Si un worker se cae a mitad, quien retoma la operación espera la misma instalación: nunca lanza un segundo stack.

¿Qué cambia realmente?

RAM, workers y topología

La cantidad de workers sale de la RAM libre real, no del plan. Además se reservan 896 MB fijos para PostgreSQL y Redis y 512 MB de holgura antes de conceder workers extra; el máximo es 8.

Cada contenedor lleva su límite de memoria y n8n recibe --max-old-space-size en torno al 75 % de ese límite, para que el recolector trabaje antes de que el sistema mate el proceso. Los logs rotan (10 MB, 3 archivos) y el historial de ejecuciones se poda a los 14 días.

Variables de entorno

• Protegidas (no se editan): N8N_ENCRYPTION_KEY, N8N_RUNNERS_AUTH_TOKEN, DB_POSTGRESDB_*, POSTGRES_*, REDIS_PASSWORD, QUEUE_BULL_REDIS_*.
• Gestionadas por la plataforma: N8N_WORKERS (escalado), WEBHOOK_URL y N8N_EDITOR_BASE_URL (dominio), EXECUTIONS_MODE, N8N_RUNNERS_MODE, N8N_PORT.
• Secretas (se muestran enmascaradas): las protegidas y cualquiera que termine en PASSWORD, SECRET, TOKEN, KEY o _PWD. Revelarlas exige admin y queda registrado.
• Los valores no pueden tener comillas, #, $, acento grave, barra invertida ni saltos de línea: un valor así no falla, vale otra cosa.

Actualizar, escalar y respaldar

• Actualizar baja las imágenes de n8n y de los runners (mismo tag), hace un volcado de la base, regenera el Compose y levanta; si la verificación falla, vuelve a la versión anterior.
• Subir workers no corta nada; bajarlos detiene primero los de índice alto con un tiempo de gracia para terminar las ejecuciones en curso.
• La copia semanal del VPS incluye los volúmenes, pero se toma en caliente; el volcado diario de /opt/n8n/backups/ es la copia consistente de la base.

Esquema

Resultado esperado

La app n8n figura en Apps como una sola app (sus contenedores son componentes) con la URL HTTPS del editor cuando el enlace está verificado.

docker compose -p n8n ps
docker logs n8n-main --tail 50

Errores y resolución

Relación con MCP

n8n se instala y opera por MCP con las herramientas de Apps (/mcp/docs, /mcp/servicios).

• Lectura: ver_preflight_app (con app_type: n8n dice si entra por RAM y Docker), ver_app, ver_operacion_app.
• Modifican: instalar_app con app_type: n8n y config opcional workers (1–8), concurrency (1–50) y version; controlar_app con restart o update; reintentar_operacion_app.
• Destructiva: desinstalar_app (solo admin). Conserva volúmenes salvo delete_data=true con confirm_delete_data=true, que borra la base de n8n.

Cualquier otro campo en config (usuarios, contraseñas) responde config_invalida. Las variables de entorno y el escalado se manejan desde el panel; las acciones solo existen para el runtime Docker (un n8n por npm responde runtime_no_soportado).

Funciones relacionadas

• Docker
• Servidores VPS
• PostgreSQL
• Redis
• Copias de seguridad
• Certificados SSL