Clase 06 · Módulo 14
Actualizar sin romper
Actualizar sin romper
Qué logras en esta clase
Actualizas n8n con un procedimiento fijo y sabes volver atrás si algo falla.
- Distingues los canales estable y beta.
- Lees las notas antes de subir.
- Actualizas con Docker Compose o con npm.
- Vuelves a la versión anterior sin perder datos.
02
Dos formas de equivocarse
| Nunca actualizar | Actualizar sin mirar |
|---|---|
| Quedas sin correcciones de seguridad | Un cambio rompe un flujo en producción |
| El salto acumulado se vuelve enorme | No sabes qué versión tenías |
| Los tutoriales nuevos ya no calzan | No puedes volver atrás |
El punto medio es un ritmo fijo y un procedimiento corto.
03
Cómo salen las versiones
n8n publica una versión menor casi todas las semanas. Hay dos canales:
- Stable: la recomendada para producción.
- Beta: la más reciente. Puede fallar.
Al 18-11-2026 la estable es la 2.48.4 y la beta la 2.49.0. Ese dato vence en días: la vigente está siempre en docs.n8n.io/release-notes.
04
Los nombres de las etiquetas cambiaron
| Antes de 2.0 | Desde 2.0 |
|---|---|
latest | stable |
next | beta |
Los nombres antiguos se retirarán en una versión mayor futura. Algunas páginas de la documentación todavía muestran next: es el mismo canal que beta.
05
En producción, versión exacta
Una etiqueta móvil cambia de contenido sola. Con la versión escrita, tú decides el día en que cambia.
06
Cómo leer un número de versión
En 2.48.4 hay tres partes:
| Parte | Ejemplo | Qué esperar |
|---|---|---|
| Mayor | 2 | Cambios incompatibles. Requiere preparación |
| Menor | 48 | Funciones nuevas y ajustes |
| Parche | 4 | Correcciones |
Subir de parche es lo más tranquilo. Subir de mayor es un proyecto pequeño en sí mismo.
07
Leer las notas antes de subir
- Mira qué versión tienes hoy.
- Abre las notas de versión y recorre desde la tuya hasta la que vas a instalar.
- Busca los nodos que usas.
- Anota cualquier cambio de comportamiento o valor por defecto.
08
Qué buscar en las notas
- Variables de entorno renombradas u obsoletas.
- Valores por defecto que cambian.
- Nodos que estrenan versión o pierden una antigua.
- Comandos que se retiran.
09
El procedimiento completo
Ningún paso se salta. El respaldo es el de la clase 5, hecho ese mismo día.
10
Actualizar con Docker Compose
- Cambia la versión en la línea
imagedel archivo Compose. - Desde la carpeta del archivo, ejecuta:
docker compose pull
docker compose down
docker compose up -dEl primero descarga la imagen nueva, el segundo detiene los contenedores y el tercero los levanta con la versión nueva. Tus datos siguen en los volúmenes.
11
Actualizar con npm o Docker Desktop
Instalación con npm, a una versión concreta:
npm install -g n8n@2.48.4npm update -g n8n sube a la última sin que elijas cuál.
En Docker Desktop: pestaña Images, menú de la fila de la imagen, Pull, y luego reinicias el contenedor.
12
Verificar después de subir
- Abre el editor y confirma la versión.
- Revisa los registros del contenedor buscando errores de arranque.
- Ejecuta a mano un flujo de solo lectura.
- Llama un webhook de producción de prueba.
- Mira la pestaña Executions durante la primera hora.
Si tu flujo de errores avisa bien (módulo 13, clase 3), él hace parte de esta vigilancia por ti.
13
Volver atrás
- Instala la versión anterior: cambia la etiqueta en el Compose o usa
npm install -g n8n@con el número anterior. - Si la versión nueva modificó la estructura de la base, deshaz esa migración:
n8n db:revertSe ejecuta una vez por cada migración aplicada. Si no basta, restauras el respaldo de la base que hiciste antes de subir.
14
La vuelta atrás se prepara antes
Volver depende de dos cosas: el respaldo de hoy y el número de la versión anterior. Sin ellas no hay marcha atrás.
15
Por qué anotar la versión anterior
Lleva una bitácora mínima: fecha, versión anterior, versión nueva y qué revisaste. Tres líneas en el mismo repositorio de tus flujos.
16
Los saltos de versión mayor
Antes de pasar de una serie a otra, lee completa la página de cambios incompatibles.
El paso de 1.x a 2.0 cambió, entre otras cosas:
- «Activar» pasó a ser «publicar».
- Se eliminó
n8n --tunnel. - MySQL y MariaDB dejaron de aceptarse. Hay una herramienta de migración de base para quienes venían de ahí.
- Varias protecciones quedaron activas por defecto (clase 4).
17
Lo que ya está anunciado
- n8n 3.0 eliminará la versión 1 del nodo AI Agent. Si tienes agentes antiguos, revisa qué versión del nodo usan.
n8n update:workflowquedó obsoleto en 2.0. Sus reemplazos sonpublish:workflowyunpublish:workflow.- La instalación con npm queda obsoleta desde n8n 3.0 (módulo 2, clase 2). Si la usas, planifica el paso a Docker.
Los avisos de «obsoleto» son tiempo regalado: corrige mientras lo viejo todavía funciona.
18
Prueba primero en una copia
Para un salto grande, no pruebes en producción.
- Restaura tu respaldo en una instalación de prueba (clase 5).
- Súbela a la versión nueva.
- Ejecuta a mano tus flujos más importantes, sin publicarlos.
- Corrige lo que falle y anótalo.
- Repite los mismos arreglos en producción.
19
Cuándo actualizar
- Con un ritmo fijo: una vez al mes funciona para la mayoría.
- De inmediato, si las notas mencionan una corrección de seguridad.
- En un horario de poco uso y con tiempo para vigilar después.
20
Con n8n Cloud
En Cloud la plataforma se encarga del servidor, pero los cambios de comportamiento te afectan igual. Las notas de versión se leen de todas formas.
Cómo y cuándo se aplica cada versión en tu cuenta se administra desde el panel de Cloud: revísalo ahí.
21
Lo que te llevas
- Canales
stableybeta; en producción, versión exacta. - Notas de versión leídas desde tu versión hasta la nueva, buscando tus nodos y variables.
- Procedimiento: leer, respaldar, cambiar, levantar, verificar.
- Para volver: versión anterior y
n8n db:revertsi hubo migración. - Los saltos mayores se ensayan en una copia.
22
Hazlo ahora
En 10 minutos:
- Mira qué versión de n8n tienes instalada.
- Abre docs.n8n.io/release-notes y cuenta cuántas versiones menores hay entre la tuya y la estable.
- Lee las notas de ese tramo y anota los cambios que tocan tus flujos.
- Agenda el día y la hora de tu próxima actualización.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- n8n release notesdocs.n8n.io ↗
- n8n v2.0 breaking changesdocs.n8n.io ↗
- Docker installation (actualizar con Docker y Compose)docs.n8n.io ↗
- npm installation (actualizar y volver atrás)docs.n8n.io ↗
- CLI commands (documentación de n8n)docs.n8n.io ↗
- AI Agent node (documentación de n8n)docs.n8n.io ↗
- n8n Docs — Variables de entorno de endpoints (N8N_WEBHOOK_URL)docs.n8n.io ↗