Skip to main content

Actualizar N8N

🧰 1. Requisitos previos

Este tutorial asume que n8n está instalado mediante Docker Compose y que la estructura es similar a:


/root/n8n/ ├── compose.yaml ├── n8n.env ├── local-files/ └── local-files-backup/

El directorio local-files/ contiene todos tus datos:

  • Flujos

  • Credenciales

  • Configuración interna de n8n


📦 2. Estructura de archivos relevante

Archivo principal del despliegue:


/root/n8n/compose.yaml

Ejemplo mínimo:


services: n8n: image: docker.n8n.io/n8nio/n8n:latest env_file: ./n8n.env ports: - "5678:5678" volumes: - ./local-files:/home/node/.n8n

🛟 3. Crear copia de seguridad

Antes de actualizar, genera un respaldo por seguridad:


cd /root/n8n cp -r local-files local-files-backup-$(date +%Y%m%d)

Opcional (si usas Postgres):


docker exec -t n8n-db pg_dumpall -c -U postgres > n8n_backup.sql

🔄 4. Actualizar n8n a la última versión estable

4.1 Detener el servicio


docker compose down

4.2 Descargar la imagen actualizada


docker compose pull

4.3 Iniciar nuevamente


docker compose up -d

Esto:

  • Conserva tus flujos

  • Mantiene credenciales

  • No borra configuraciones

  • Levanta n8n con la nueva versión disponible


🔍 5. Verificar la versión de n8n

Ejecuta:


docker compose exec n8n n8n --version

Deberías ver algo como:


1.122.4

(la actual estable antes del lanzamiento de n8n 2.0)


🧹 6. Limpiar imágenes antiguas (opcional)

Si deseas liberar espacio:


docker image prune -f

🔁 7. Rollback (volver a la versión anterior)

Si algo sale mal:

7.1 Edita compose.yaml y fija la versión previa

Ejemplo:


image: docker.n8n.io/n8nio/n8n:1.122.4

7.2 Levántalo:


docker compose down docker compose up -d

7.3 Restaurar datos si fuera necesario


rm -r local-files cp -r local-files-backup-YYYYMMDD local-files

📝 8. Notas adicionales

  • n8n 2.0.0 estable llegará el 15 de diciembre.

  • Hasta ese día, latest seguirá señalando versiones 1.x.

  • La actualización a 2.0.0 requerirá pasos adicionales, ya que será una major release con cambios incompatibles.

  • Se recomienda realizar un backup completo antes de actualizar a cualquier versión mayor.