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.
n8n 3.0 está anunciado para octubre de 2026 y, al 8 de octubre, todavía no se había publicado: la última versión estable que n8n ofrecía ese día era la 2.42.5. 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 8 de octubre de 2026 en las páginas de n8n:
- La documentación de n8n dice que la transición a la 3.0 está programada para octubre de 2026. Su página de cambios incompatibles aclara que se irá completando a medida que se acerque el lanzamiento y que la guía paso a paso para pasar a Docker llegará pronto.
- No hay una versión 3.0 publicada. En GitHub, las versiones de ese día eran la 2.42.5 (estable), la 2.43.2 (beta) y la 1.123.84 de la línea 1.x. 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, publicada el 6 de octubre de 2026 y todavía en beta ese día, 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. n8n espera que Docker Compose sea el camino más simple |
| 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 |
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 se activa por defecto | 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
- 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.
- 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. - 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».
- Busca los nodos quitados en tus flujos y reemplázalos, siempre en una copia de prueba.
- Revisa los disparadores de Gmail y los agentes de IA que sean de versiones antiguas.
- Revisa tus variables de entorno, en el archivo de Docker Compose o donde las definas.
- Si usas npm, planea el paso a Docker. Es el cambio de más peso, y la guía paso a paso de n8n aún no estaba publicada.
- 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.
- 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 el 8 de octubre de 2026 n8n seguía publicando versiones de la 1.x y de la 2.x. 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?
La documentación de n8n dice octubre de 2026. Al 8 de octubre no había una fecha confirmada ni una versión 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. 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.
Estado al 8 de octubre de 2026, según la documentación de n8n (página de cambios incompatibles de la 3.0, guías de respaldo y de actualización, notas de la versión 2.43) y las versiones publicadas en GitHub. Sin fecha ni lanzamiento confirmado: revisa esta guía el día que n8n publique la 3.0 y, a más tardar, el 31 de octubre de 2026. n8n es una marca registrada de n8n GmbH, y PaginasWeb1 no está afiliada a n8n GmbH ni cuenta con su patrocinio.
¿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.
Seguir leyendo
Make vs Zapier vs n8n para una pyme: cómo cuenta cada una lo que consumes y cuál conviene
Make, Zapier y n8n comparadas sin precios que caducan: qué cuenta cada una (tareas, créditos o ejecuciones), dónde corre y cuál conviene según tu caso.
Qué es n8n y para qué sirve en una pyme: qué hace, cuánto cuesta y qué dice su licencia
Qué es n8n, qué se puede hacer con él en una pyme chilena, si es gratis, qué dice su licencia fair-code y de qué se compone el costo.
WhatsApp Business app o API: cuál necesita tu negocio y qué cambió el 1 de octubre
Diferencias entre la app de WhatsApp Business y la API, qué pasa con tu número si pasas a la API y qué cambió el 1 de octubre de 2026 en el cobro de Meta.