n8n 3.0: checklist para migrar tu n8n autoalojado antes de actualizar

Qué cambia en n8n 3.0 (Docker obligatorio, nodos quitados, nuevos valores por defecto) y una lista de pasos para prepararte antes de actualizar tu n8n autoalojado.

Ilustración isométrica: un contenedor con la puerta roja unido por una línea de puntos a una lista de verificación con dos marcas

n8n 3.0 todavía no se publica y n8n ya no le pone fecha: su documentación solo dice que saldrá pronto. Al 17 de octubre de 2026, la última versión estable era la 2.43.7. Mientras no actualices, nada cambia en tu instancia. Pero conviene prepararse ahora, porque la 3.0 exige instalar n8n con Docker (deja de soportar npm y npx), quita nodos antiguos y cambia valores por defecto que pueden hacer fallar flujos que hoy funcionan.

Esta guía es para quien tiene n8n instalado en un servidor propio. Reúne lo que n8n ha anunciado, lo ordena por áreas y termina en una lista de pasos antes de actualizar. Mantener n8n al día es parte de lo que hacemos en nuestro servicio de automatización con IA, así que escribimos desde esa práctica, y lo decimos para que lo leas con eso en mente. Si n8n es nuevo para ti, empieza por qué es n8n y para qué sirve en una pyme.

En qué estado está n8n 3.0

Esto es lo que se pudo comprobar el 17 de octubre de 2026 en las páginas de n8n:

  • La documentación de n8n ya no da una fecha. Hasta el 8 de octubre, su página de cambios incompatibles decía que la 3.0 estaba programada para octubre de 2026. Desde el 16 de octubre dice que saldrá pronto (entre el 9 y el 16 de octubre decía, por error, que ya se había publicado). También dejó de anunciar una guía paso a paso para pasar a Docker: ahora recomienda su instalación de una línea, que sirve para instancias nuevas y no para mover una existente.
  • No hay una versión 3.0 publicada. En GitHub, las últimas eran la 2.43.7 (estable) y la 2.44.3 (beta), del 16 de octubre, y la 1.123.85 de la línea 1.x, del 14 de octubre. Entre las versiones publicadas no hay ninguna 3.x, aunque el repositorio tiene una rama llamada 3.x.
  • El informe de migración ya existe en la 2.x. Está en Settings > Migration Report, solo para administradores globales, y la versión 2.43, estable desde el 12 de octubre de 2026, lo mejoró: rotula cada cambio como «Upgrade blocked», «Executions fail», «Behavior changes» o «Capability removed».

No hay fecha confirmada. Lo sensato es hacer ahora lo que no depende de ella: revisar tus flujos y tu instalación.

Qué cambia: instalación y nodos

Qué Qué dice n8n que cambia en la 3.0 Qué hacer
Instalación El n8n autoalojado exige una instalación con Docker. Ya no se soporta instalar con npm ni ejecutar npx n8n Si usas npm, planea el paso a Docker antes de actualizar. Para una instancia nueva, n8n recomienda su instalación de una línea. Si ya usas tu propio archivo de Docker Compose, no hace falta cambiarlo
Nodos Function y Function Item Se quitan Pasa a Code: modo «Run Once for All Items» reemplaza a Function y «Run Once for Each Item» a Function Item
Nodo Item Lists Se quita Usa el nodo que corresponde a tu operación: Split Out, Aggregate, Sort, Limit, Remove Duplicates o Summarize
Nodos Cron e Interval Se quitan Reemplázalos por Schedule Trigger
Nodos de archivos y PDF Se quitan Read PDF, HTML Extract y los nodos Read o Write Binary File Usa Extract from File, el nodo HTML con «Extract HTML Content» y Read/Write Files from Disk
Nodos de OpenAI y de herramientas antiguos Se quitan el nodo OpenAI antiguo, OpenAI Assistant, OpenAI Model y el HTTP Request Tool antiguo. El nodo OpenAI actual se queda Pasa al nodo OpenAI actual, a OpenAI Chat Model y al nodo HTTP Request conectado como herramienta del agente
AI Agent versión 1 Se quita la versión 1 y sus modos (SQL Agent, Conversational Agent, OpenAI Functions Agent, Plan and Execute Agent y ReAct Agent) Actualiza al AI Agent más nuevo. Los flujos que ya usan Tools Agent siguen igual
Gmail Trigger anterior a 1.4 Las versiones 1 a 1.3 pasan a comportarse como la 1.4: máximo de 10 correos por revisión (configurable hasta 50), sin borradores salvo que actives «Include Drafts», y los enviados o programados ya no disparan el flujo Si tu flujo depende de borradores o de correos enviados, ajústalo o cambia el disparador por Schedule Trigger y la operación «Get Many» de Gmail
Disparador de Slack La credencial «Slack API» exige el «Signing Secret» de tu app de Slack. Sin él, los flujos que empiezan con Slack Trigger no se pueden publicar y el disparador responde con un error 401 Antes de actualizar, copia el «Signing Secret» desde «Basic Information» en la configuración de tu app de Slack, pégalo en la credencial y vuelve a publicar el flujo
«Always Output Data» en If y Switch Con esa opción activa, los nodos con varias salidas agregan un elemento vacío solo cuando todas sus salidas quedan vacías. Antes lo agregaban en cada salida vacía, y así corrían ramas que no debían correr Busca en el informe de migración los nodos afectados y ajusta la opción según lo que esperas que haga cada flujo

Es una lista parcial: la de n8n incluye más nodos, entre ellos varios de memoria y de almacenes de vectores para IA. El informe de migración de tu propia instancia dice cuáles de todos usas.

Qué cambia: valores por defecto y funciones retiradas

Área Qué cambia Qué revisar
Tiempo de las tareas de código El tiempo máximo del nodo Code baja de 5 minutos a 1 minuto Si un flujo ejecuta código más de un minuto, define el valor de N8N_RUNNERS_TASK_TIMEOUT de forma explícita
Carpeta de archivos binarios ~/.n8n/binaryData pasa a llamarse ~/.n8n/storage. Si existen las dos carpetas, n8n no arranca Si montas un volumen en la ruta antigua, móntalo en la nueva o fija N8N_STORAGE_PATH
Modo «default» de datos binarios Deja de ser válido y se pasa a sistema de archivos Elige filesystem, s3, azure o database, y comprueba que el disco tenga espacio
Nodos de la comunidad sin verificar Quedan desactivados por defecto Si usas alguno, activa N8N_UNVERIFIED_PACKAGES_ENABLED
Seguridad La lista de direcciones bloqueadas contra SSRF crece (incluye el espacio compartido 100.64.0.0/10), los límites al descomprimir archivos bajan y la rotación de claves de cifrado se activa por defecto (desde la 2.40.3 se puede volver a apagar) Si un flujo llama a servidores en esos rangos, agrégalos a la lista de permitidos. Si descomprime archivos grandes, sube los límites a mano
Funciones retiradas Chat Hub queda desactivado (n8n 4.0 lo quita), se quita importar un flujo desde una URL en el editor y se quita la pestaña «Ask AI» del nodo Code Si usas Chat Hub, agrega chat-hub a N8N_ENABLED_MODULES

Checklist antes de actualizar

  1. Anota qué tienes. La versión que corre y cómo se instaló, con npm o con Docker. Es lo que decide cuánto trabajo viene.
  2. Haz una copia completa. Según la guía de n8n, una copia completa incluye la carpeta .n8n (donde está la clave que cifra tus credenciales), la base de datos si usas PostgreSQL y el almacenamiento externo o los nodos propios si los tienes. La exportación por línea de comandos solo guarda flujos y credenciales: no trae usuarios, historial de ejecuciones, variables ni la clave de cifrado. n8n recomienda hacer una copia completa antes de actualizar.
  3. Abre el informe de migración y apunta cuántos flujos aparecen con problemas y de qué tipo. Parte por los «Upgrade blocked» y los «Executions fail».
  4. Busca los nodos quitados en tus flujos y reemplázalos, siempre en una copia de prueba.
  5. Revisa los disparadores de Gmail y los agentes de IA que sean de versiones antiguas.
  6. Revisa tus variables de entorno, en el archivo de Docker Compose o donde las definas.
  7. Si usas npm, planea el paso a Docker. Es el cambio de más peso. n8n no ha publicado una guía para mover una instalación existente, y su instalación de una línea es para instancias nuevas: el traspaso hay que armarlo y probarlo con la copia completa a mano.
  8. Prueba en otra instancia. n8n recomienda probar la actualización en una versión de prueba antes de hacerla en la real. Para una instalación común, eso es levantar otra instancia con una copia de los datos y ejecutar a mano tus flujos importantes.
  9. Actualiza la instancia real con un plan para volver atrás: la copia completa guardada, y la imagen o la versión anterior a mano para restaurarla si algo falla.

Un criterio nuestro, y no de n8n: no actualizar producción a una versión mayor el mismo día que sale. Conviene esperar a que pase de la beta a la estable y leer las notas con calma.

Un ejemplo con tres flujos

Ejemplo armado para explicar, no un cliente real: una distribuidora con n8n instalado con npm en un servidor Ubuntu y tres flujos. El primero busca precios con un nodo Function. El segundo revisa una planilla cada lunes con un nodo Cron. El tercero lee un correo con un Gmail Trigger en versión 1.1 que, por esa versión, incluye borradores.

El informe de migración marcaría los tres. El primero se rehace con el nodo Code, el segundo con Schedule Trigger y, en el tercero, hay que decidir si los borradores deben seguir disparando el flujo, porque en la 3.0 ya no lo hacen salvo que se active «Include Drafts». Y como la instalación es con npm, antes de todo eso hay que pasar a Docker.

¿Qué pasa si no actualizo?

La guía de actualización de n8n recomienda actualizar con frecuencia, al menos una vez cada mes, para no tener que saltar varias versiones de golpe. No encontramos en el índice de su documentación una política ni una fecha de fin de soporte para la línea 2.x, y al 17 de octubre de 2026 n8n seguía publicando versiones de la 1.x y de la 2.x (la 1.123.85 salió el 14 de octubre). Por eso no hay apuro para ser el primero en pasar a la 3.0, pero tampoco conviene quedarse años atrás: cuanto más grande el salto, más cambios juntos.

Cómo lo hacemos nosotros

En los servidores que instalamos para clientes el n8n ya corre en Docker, junto a PostgreSQL, así que el cambio de npm a Docker no aplica. Los respaldos de los flujos se guardan fuera del servidor, y le entregamos al cliente la clave con que n8n cifra sus credenciales, sin la cual un respaldo no las recupera. Las actualizaciones de n8n van dentro de la mantención del servicio. Para una versión mayor como esta, el orden que seguiríamos es el de la lista de arriba: copia completa, informe de migración, prueba en otra instancia y recién después la instancia real. El servidor sigue a nombre del cliente, por la licencia que explica qué es n8n. Para ver cómo se arma un flujo con correo, está automatizar correos con IA.

Preguntas frecuentes

¿Cuándo sale n8n 3.0?

n8n no ha dado una fecha. Hasta el 8 de octubre su documentación decía octubre de 2026, y desde el 16 de octubre dice que saldrá pronto. Al 17 de octubre no había ninguna versión 3.x publicada.

¿Se van a romper mis flujos?

Solo los que usen lo que n8n quita o cambia: nodos antiguos, ciertas versiones de nodos y algunos valores por defecto. El informe de migración de tu instancia cuenta cuántos flujos están afectados.

¿Puedo seguir con npm?

En la 3.0 no: n8n anunció que dejará de soportar la instalación con npm y con npx n8n. Su página de instalación dice que una instalación con npm que ya existe sigue funcionando por ahora, y seguir en la 2.x es posible mientras n8n la mantenga.

¿Hay que pagar algo por actualizar?

El programa, instalado por ti para tus procesos internos, no tiene costo de licencia. Lo que cuesta es el tiempo de revisar y probar los flujos, y el servidor de prueba si lo necesitas.

Publicada el 8 de octubre de 2026 y revisada el 17 de octubre de 2026, según la documentación de n8n (página de cambios incompatibles de la 3.0 y su historial de cambios en GitHub, instalación de una línea, guías de respaldo y de actualización, notas de la versión 2.43) y las versiones publicadas en GitHub y npm. Sin fecha ni lanzamiento confirmado: revisa esta guía el día que n8n publique la 3.0 y, a más tardar, el 30 de noviembre de 2026. n8n es una marca registrada de n8n GmbH, y PaginasWeb1 no está afiliada a n8n GmbH ni cuenta con su patrocinio.

¿Te sirvió? Compártelo WhatsApp Facebook LinkedIn

¿Prefieres que lo montemos nosotros?

Instalamos n8n en un servidor a nombre de tu empresa, conectamos tu casilla con un modelo de IA y partimos en modo borrador: la IA escribe y tú apruebas. El diagnóstico no tiene costo.

¿Quieres ver si tu casilla se puede automatizar?

Cuéntanos qué correos contestas más y cuántos llegan al día. Te respondemos el mismo día hábil, y si no conviene automatizar, te lo decimos.

Casilla de correo con IA desde $100.300 al mes. Lo demás, a medida.

¿Qué necesitas?

Te respondemos el mismo día hábil. El diagnóstico no tiene costo ni compromiso.
Usamos tus datos solo para responder esta consulta y no los compartimos con terceros. Política de privacidad.

Seguir leyendo

Ver Planes