Saltar al contenido principal

Instalación con npm

npm es una de las formas más rápidas de iniciar n8n en tu equipo local. Debes tener instalado Node.js. n8n requiere una versión de Node.js entre la 20.19 y la 24.x (incluyendo ambas versiones límite).

Versiones estables y beta​

n8n publica casi semanalmente una nueva versión menor. La versión stable está pensada para entornos de producción, mientras que la versión beta corresponde a la última versión publicada y puede no ser completamente estable. Si deseas reportar algún problema, por favor usa el foro comunitario.

Versión stable actual: 2.10.2
Versión beta actual: 2.11.1

Probar n8n con npx​

Puedes probar n8n sin necesidad de instalarlo, usando npx.

Ejecuta en tu terminal:

npx n8n

Este comando descargará todo lo necesario para iniciar n8n. Una vez finalizado, abre http://localhost:5678 en tu navegador para acceder a n8n y comenzar a crear flujos de trabajo.

Instalación global de n8n (con npm)​

Instala n8n globalmente mediante npm:

npm install n8n -g

Puedes usar la sintaxis con @ para instalar o actualizar a una versión específica de n8n. Por ejemplo:

npm install -g [email protected]

Para instalar la versión next:

npm install -g n8n@next

Una vez instalado, inicia n8n con el siguiente comando:

n8n
# o
n8n start

Pasos siguientes​

Consulta la guía de inicio rápido para explorar las funcionalidades de n8n.

Actualización​

Actualiza tu instancia de n8n a la versión latest:

npm update -g n8n

Para instalar la versión next:

npm install -g n8n@next

Uso del túnel de n8n (Tunnel)​

⚠️ Advertencia

Únicamente para desarrollo y pruebas locales. No es adecuado para entornos de producción.

Herramienta de desarrollo

La funcionalidad de túnel es una herramienta útil para desarrollo local, cuya implementación interna puede cambiar entre versiones de n8n.

Para utilizar nodos disparadores de servicios externos como GitHub mediante webhooks, n8n debe ser accesible desde Internet. n8n ofrece un servicio de túnel basado en cloudflared que redirige solicitudes de red a tu instancia local de n8n. Esta funcionalidad requiere Docker.

Requisito: Docker​

El túnel utiliza cloudflared, que se ejecuta como un contenedor Docker. Aunque estés ejecutando n8n mediante npm, necesitas tener instalado Docker en tu máquina.

Para instalaciones con npm, utiliza el modo solo servicio: inicia cloudflared como un servicio independiente y luego ejecuta n8n localmente:

# Terminal 1: Iniciar el servicio de túnel cloudflared
pnpm --filter n8n-containers services --services cloudflared

# Terminal 2: Iniciar n8n localmente
pnpm dev

📝 Nota: Los comandos con pnpm requieren tener el repositorio de n8n clonado localmente. No son compatibles con instalaciones globales realizadas mediante npm install -g.

El comando services iniciará cloudflared, obtendrá una URL pública de túnel y generará un archivo .env en packages/cli/bin/.env con las variables WEBHOOK_URL y N8N_PROXY_HOPS=1. n8n leerá automáticamente este archivo al iniciarse.

Para limpiar tras su uso:

pnpm --filter n8n-containers services:clean

Para el modo de pila completa (donde tanto n8n como cloudflared se ejecutan dentro de contenedores), consulta la configuración del túnel con Docker.

Revertir una actualización​

Instala la versión anterior a la que deseas volver.

Si la actualización incluyó migraciones de base de datos:

  1. Consulta la documentación de características y las notas de la versión para verificar si se requieren cambios manuales.
  2. Ejecuta n8n db:revert en la versión actual para revertir la base de datos. Si necesitas deshacer varias migraciones, deberás repetir este paso tantas veces como sea necesario.

Solución de problemas en Windows​

Si experimentas problemas al ejecutar n8n en Windows, asegúrate de que tu entorno de Node.js esté correctamente configurado. Consulta la guía de Microsoft sobre cómo instalar Node.js en Windows.