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.