Cómo Actualizar n8n: Guía Paso a Paso sin Perder Datos

Cómo actualizar n8n: guía paso a paso si quieres mantener tu instancia al día sin perder ningún workflow ni credencial. Actualizar n8n es fundamental para acceder a las últimas funcionalidades, correcciones de seguridad y nuevos nodos. En esta guía completa te explico exactamente cómo actualizar n8n de forma segura según tu método de instalación — ya sea Docker Compose, Docker run, npm o incluso Railway — para que todo el proceso sea rápido, sencillo y sin sorpresas desagradables.

¿Por qué es importante actualizar n8n regularmente?

Antes de meternos en los comandos, es clave entender por qué deberías actualizar n8n con frecuencia. Cada nueva versión trae mejoras que impactan directamente tu productividad:

Nuevos nodos e integraciones: n8n agrega constantemente conectores con herramientas populares como Notion, Slack, Google Sheets y más.
Parches de seguridad: las versiones antiguas pueden tener vulnerabilidades que comprometan tus credenciales y datos sensibles.
Mejoras de rendimiento: cada release optimiza el consumo de memoria y la velocidad de ejecución de workflows.
Corrección de bugs: si algún nodo falla o tiene comportamiento inesperado, probablemente ya lo solucionaron en una versión más reciente.

Dicho esto, actualizar sin precaución puede generar problemas. Por eso el primer paso siempre es hacer un respaldo completo.

¿Por qué es importante actualizar n8n regularmente?

Cómo actualizar n8n: paso 1 — Haz un backup antes de todo

Este es el paso más importante de toda la guía. No importa qué método de instalación uses, siempre haz un backup antes de actualizar n8n. Si algo sale mal, podrás restaurar todo en minutos.

Backup con PostgreSQL (Docker)

# Backup de la base de datos PostgreSQL
docker compose exec -T postgres pg_dump -U n8n n8n > backup_antes_update.sql

# Exportar todos los workflows como archivos JSON
docker compose exec n8n n8n export:workflow --all --output=/tmp/backup_workflows/

# Exportar credenciales (opcional pero recomendado)
docker compose exec n8n n8n export:credentials --all --output=/tmp/backup_credentials/

Backup con SQLite (instalación por defecto)

# Si usas SQLite, simplemente copia el directorio de datos
cp -r ~/.n8n ~/.n8n_backup_$(date +%Y%m%d)

# O si usas Docker con volumen
docker cp n8n:/home/node/.n8n ./n8n_backup_$(date +%Y%m%d)

Con el respaldo listo, ahora sí podemos proceder con la actualización.

Cómo actualizar n8n: paso 1 — Haz un backup antes de todo

Cómo actualizar n8n con Docker Compose (método recomendado)

Docker Compose es el método más común y el más sencillo para actualizar la versión de n8n. Solo necesitas tres comandos:

# Ir al directorio donde tienes tu docker-compose.yml
cd /opt/n8n

# Descargar la nueva imagen de n8n
docker compose pull

# Reiniciar solo el contenedor de n8n (sin tocar la base de datos)
docker compose up -d --no-deps n8n

# Verificar que arrancó correctamente
docker compose logs -f n8n

El proceso completo tarda menos de 2 minutos. Si la nueva versión incluye migraciones de base de datos, n8n las aplica automáticamente al arrancar — no necesitas hacer nada adicional.

Cómo actualizar n8n con Docker run (sin Compose)

Si usas Docker sin Compose, el proceso tiene un par de pasos extra pero sigue siendo bastante directo:

# Detener el contenedor actual
docker stop n8n

# Eliminar el contenedor (los datos están en el volumen, NO se pierden)
docker rm n8n

# Descargar la última imagen
docker pull n8nio/n8n

# Arrancar con la misma configuración de antes
docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  -e N8N_HOST=tudominio.com \
  -e N8N_PROTOCOL=https \
  n8nio/n8n

Tip importante: asegúrate de usar exactamente las mismas variables de entorno y volúmenes que tenías antes. Si no recuerdas la configuración original, revísala con docker inspect n8n antes de eliminar el contenedor.

Cómo actualizar n8n instalado con npm

Si instalaste n8n directamente con npm en tu servidor, la actualización es todavía más simple:

# Actualizar n8n a la última versión
npm update -g n8n

# Verificar la versión instalada
n8n --version

Si usas pm2 para gestionar el proceso de n8n (lo cual es muy recomendable en producción):

# Detener n8n
pm2 stop n8n

# Actualizar el paquete
npm update -g n8n

# Reiniciar n8n
pm2 start n8n

# Verificar que está corriendo
pm2 status

Cómo actualizar n8n a una versión específica

A veces no quieres la última versión sino una versión específica de n8n — por ejemplo, porque la más reciente tiene un bug conocido o porque necesitas probar una función particular:

# Con Docker Compose, edita tu docker-compose.yml:
image: n8nio/n8n:1.68.0

# Luego aplica el cambio:
docker compose up -d --no-deps n8n

# Con npm:
npm install -g n8n@1.68.0

# Con Docker run:
docker pull n8nio/n8n:1.68.0

Puedes consultar todas las versiones disponibles en hub.docker.com/r/n8nio/n8n/tags. También te recomiendo revisar el changelog oficial antes de actualizar para saber qué cambió.

Cómo actualizar n8n en Railway

Si tienes n8n desplegado en Railway, el proceso es diferente porque no usas comandos directamente. Sigue estos pasos:

Ve a tu proyecto en el dashboard de Railway.
Selecciona el servicio donde corre n8n.
Navega a Settings → Source.
Cambia la versión de la imagen Docker a la que deseas (por ejemplo, n8nio/n8n:1.68.0 o n8nio/n8n:latest).
Railway redespliega automáticamente con la nueva versión.
Revisa los logs del servicio para confirmar que todo arrancó correctamente.

Nota: si usas Railway con un template, es posible que la imagen se actualice automáticamente. Verifica la configuración de tu servicio para evitar actualizaciones inesperadas.

Qué hacer si la actualización de n8n falla

Si algo sale mal al actualizar n8n, no entres en pánico. Sigue estos pasos en orden:

Revisa los logs inmediatamente: docker compose logs n8n te mostrará el error exacto. Los más comunes son problemas de migración de base de datos o incompatibilidad con nodos comunitarios.
Vuelve a la versión anterior: especifica la versión previa en tu docker-compose.yml y reinicia.
Restaura el backup: si la base de datos se corrompió durante la migración, restaura el respaldo que hiciste al inicio.

# Rollback: volver a la versión anterior
docker compose stop n8n

# Edita docker-compose.yml y cambia la imagen:
# image: n8nio/n8n:VERSION_ANTERIOR

# Reiniciar con la versión anterior
docker compose up -d n8n

# Si necesitas restaurar el backup de PostgreSQL:
cat backup_antes_update.sql | docker compose exec -T postgres psql -U n8n n8n

En mi experiencia, la mayoría de problemas se resuelven simplemente revisando los logs. Las fallas graves que requieren restaurar backup son muy raras.

Qué hacer si la actualización de n8n falla

Cómo automatizar las actualizaciones de n8n con Watchtower

Si quieres que n8n se actualice automáticamente cada vez que haya una nueva versión disponible, puedes usar Watchtower. Simplemente agrega este servicio a tu docker-compose.yml:

services:
  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --interval 86400 n8n
    # Comprueba cada 24 horas si hay nueva versión
    restart: unless-stopped

Advertencia importante: las actualizaciones automáticas sin revisar el changelog pueden romper workflows si hay cambios importantes (breaking changes). Yo personalmente recomiendo Watchtower solo para entornos de desarrollo o pruebas. Para producción, es mejor actualizar manualmente después de revisar las notas de la versión.

Mejores prácticas para actualizar n8n sin perder datos

Después de hacer muchas actualizaciones, estas son las prácticas que te recomiendo seguir siempre:

Haz backup SIEMPRE antes de actualizar — incluso si la actualización parece menor.
Revisa el changelog en el repositorio oficial de n8n en GitHub antes de cada actualización.
No saltes muchas versiones de golpe. Si estás muy atrás, actualiza de a pocas versiones para evitar problemas con las migraciones.
Prueba en un entorno de staging antes de actualizar producción, especialmente si manejas workflows críticos.
Actualiza los nodos comunitarios después de actualizar n8n, ya que algunas versiones nuevas pueden requerir actualizaciones de compatibilidad.
Documenta qué versión usas para poder hacer rollback fácilmente si es necesario.

Preguntas frecuentes sobre cómo actualizar n8n

¿Se pierden los workflows al actualizar n8n?

No, los workflows y credenciales se almacenan en la base de datos o en volúmenes de Docker. Al actualizar n8n solo se reemplaza la aplicación, no los datos. Sin embargo, siempre es recomendable hacer un backup antes por precaución.

¿Cada cuánto debería actualizar n8n?

Lo ideal es actualizar al menos una vez al mes o cuando haya actualizaciones de seguridad. Revisa el changelog para decidir si la actualización es relevante para tu caso de uso.

¿Puedo volver a una versión anterior de n8n si algo falla?

Sí, puedes hacer rollback especificando la versión anterior en tu docker-compose.yml o reinstalando con npm. Si restauras un backup de la base de datos, volverás exactamente al estado previo a la actualización.

¿Cómo sé qué versión de n8n tengo instalada?

Puedes verificarlo de varias formas: en la interfaz web de n8n aparece la versión en la esquina inferior, con el comando n8n --version si usas npm, o con docker compose logs n8n | head si usas Docker.

¿Es seguro usar Watchtower para actualizar n8n automáticamente?

Watchtower funciona bien para entornos de desarrollo, pero no es recomendable para producción. Las actualizaciones automáticas pueden incluir breaking changes que rompan workflows existentes sin que te des cuenta.

¿Vale la pena? Nuestra opinión

Actualizar n8n es un proceso que, bien hecho, toma menos de 2 minutos y te mantiene protegido con los últimos parches de seguridad. La clave de esta guía paso a paso es simple: haz siempre un backup antes, revisa el changelog en versiones mayores y ten a mano el procedimiento de rollback por si acaso. Con estas prácticas, nunca perderás datos ni workflows al actualizar.

Si te interesa sacar más provecho de n8n, te recomiendo revisar nuestras otras guías sobre automatización con n8n y cómo instalar n8n con Docker desde cero.

También te puede interesar

Resumir con: