Clase 02 · Módulo 02
Instalar n8n con Node y npm
Instalar n8n con Node y npm
Qué logras en esta clase
Dejas n8n funcionando en tu computador con dos comandos.
- Compruebas que tu versión de Node sirve.
- Instalas, arrancas y detienes n8n.
- Actualizas a una versión exacta y vuelves atrás si algo falla.
02
Qué son Node y npm
Node.js es un programa que permite ejecutar JavaScript fuera del navegador. n8n está hecho sobre él: sin Node, no arranca.
npm es el instalador de paquetes que viene con Node. Con un comando descarga n8n y lo deja disponible en tu terminal.
La terminal es la ventana donde escribes comandos (vista en Claude de verdad, en la introducción a Claude Code).
03
Con npm, n8n es un programa más
Corre directo en tu sistema, sin capas intermedias. Es el camino más rápido para empezar y el más frágil para dejar funcionando meses.
04
npm o Docker
| npm (esta clase) | Docker (clase 3) | |
|---|---|---|
| Tiempo para partir | Minutos | Un poco más |
| Depende de tu Node | Sí | No |
| Igual al servidor | No | Sí |
| Futuro | Obsoleto desde n8n 3.0 | Método recomendado |
Usa npm para aprender hoy. Para lo que quede corriendo, Docker.
05
Lo malo de este camino
No es motivo para saltarte la clase: entender esta instalación te deja claro qué hace Docker por ti después.
06
Qué versión de Node sirve
n8n admite Node desde la 20.19 hasta la 24.x, ambas incluidas. Ni más vieja ni más nueva.
Para ver la tuya, abre la terminal y escribe:
node -vSi responde algo como v22.14.0, estás dentro del rango. Si dice que no reconoce el comando, no tienes Node.
07
Instalar Node paso a paso
- Entra a nodejs.org, el sitio oficial.
- Descarga el instalador para tu sistema, eligiendo una versión dentro del rango.
- Instálalo con las opciones por defecto.
- Cierra la terminal y abre una nueva.
- Comprueba con
node -vynpm -v.
En Windows, la documentación de n8n remite a la guía de Microsoft para instalar Node.
08
No instales la más nueva sin mirar
Si necesitas varias versiones de Node en el mismo equipo, existe un tipo de herramienta para cambiar entre ellas (nvm es la más conocida).
09
Probar sin instalar nada
npx n8nnpx descarga n8n de forma temporal y lo ejecuta. Sirve para mirar. Tarda la primera vez porque baja muchos archivos.
Para trabajar de verdad, instálalo.
10
Instalar y arrancar
npm install n8n -g
n8n start- La
-gsignifica global: el comandon8nqueda disponible en cualquier carpeta. n8na secas hace lo mismo quen8n start.
Cuando la terminal muestre la dirección, abre http://localhost:5678 en el navegador.
11
Qué pasa al arrancar
localhost significa «este mismo computador». El 5678 es el puerto, la puerta por la que n8n atiende. Nadie fuera de tu equipo puede entrar a esa dirección.
12
La terminal es el interruptor
n8n vive mientras esa terminal siga abierta. Si la cierras o apagas el equipo, los flujos dejan de correr.
13
Detener y volver a abrir
- En la terminal donde corre n8n, pulsa
Ctrl + C. - Espera a que termine de cerrar.
- Para volver, escribe
n8n start.
Tus flujos no se pierden al detenerlo: están guardados en disco.
14
Dónde quedan tus datos
n8n crea una carpeta llamada .n8n dentro de tu carpeta personal de usuario. Ahí viven:
- La base de datos con flujos, credenciales y ejecuciones.
- El archivo de ajustes con la clave de cifrado (clase 6).
El punto inicial la vuelve oculta. En Windows suele estar en C:\Users\tu-usuario\.n8n.
15
Fija la zona horaria
Una instalación propia usa por defecto la zona horaria de Nueva York. Un flujo programado «a las 8» correría a otra hora en Chile.
La variable GENERIC_TIMEZONE lo corrige. Se define en la misma terminal, antes de arrancar:
# macOS y Linux
export GENERIC_TIMEZONE="America/Santiago"
# Windows (PowerShell)
$env:GENERIC_TIMEZONE = "America/Santiago"Dura solo esa sesión de terminal. La clase 6 explica cómo dejarla fija.
16
Windows y los permisos del archivo
n8n 2 exige que su archivo de ajustes tenga permisos restringidos. Windows no maneja permisos de esa forma.
Si al arrancar aparece una advertencia sobre los permisos de ese archivo, define antes esta variable:
$env:N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS = "false"En macOS y Linux no la toques: ahí la protección funciona y conviene dejarla activa.
17
Actualizar
npm update -g n8nAntes de ejecutarlo:
- Lee las notas en docs.n8n.io/release-notes.
- Detén n8n con
Ctrl + C. - Copia la carpeta
.n8ncompleta a otro lugar.
Sale una versión casi cada semana. No necesitas todas: actualiza con calma, una vez al mes o cuando haya un arreglo de seguridad.
18
Una copia vale más que un arreglo
Copiar la carpeta .n8n antes de actualizar toma diez segundos. Recuperarte sin esa copia puede tomar la tarde.
19
Instalar una versión exacta
npm install -g n8n@2.48.4El número después de la arroba es la versión. Ese es un ejemplo: usa la que elegiste en las notas de versión.
| Qué instalas | Para qué |
|---|---|
| Versión exacta | Saber siempre qué tienes |
npm update | Subir a la estable más reciente |
n8n@beta | Probar lo más nuevo, puede fallar (antes se llamaba next) |
20
Volver atrás
- Revisa en las notas si la versión nueva pide pasos manuales.
- Si hubo una migración de la base, ejecuta
n8n db:revert, una vez por cada migración. - Instala la versión anterior con
npm install -g n8n@y su número. - Arranca y revisa que los flujos abran.
Una migración es un cambio que la versión nueva aplica a la estructura de la base de datos.
21
Cuando no parte
| Lo que ves | Causa probable |
|---|---|
No reconoce node o npm | Node no está instalado o no reabriste la terminal |
No reconoce n8n | Faltó la -g al instalar |
| Falla al arrancar | Node fuera del rango 20.19 a 24.x |
| El puerto 5678 está ocupado | Ya hay otro n8n abierto |
22
Lo que te llevas
- n8n con npm necesita Node entre 20.19 y 24.x.
npm install n8n -ginstala;n8n startarranca;Ctrl + Cdetiene.- Todo queda en la carpeta
.n8nde tu usuario. - Antes de actualizar: leer las notas y copiar esa carpeta.
- Este método sirve para aprender; queda obsoleto en n8n 3.0.
23
Hazlo ahora
En 15 minutos:
- Ejecuta
node -vy confirma que estás en el rango. - Define
GENERIC_TIMEZONEe instala n8n. - Arranca y abre
http://localhost:5678. No crees la cuenta todavía: eso es la clase 4. - Ubica la carpeta
.n8nen tu equipo. - Detén n8n con
Ctrl + Cy vuelve a arrancarlo.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026