¿Qué es n8n?
n8n es una herramienta de automatización de workflows: conectás servicios, definís qué tiene que pasar cuando ocurre algo y dejás que se ejecute solo. Sin escribir código, arrastrando y conectando nodos en una grilla visual.
El nombre viene de nodemation — node + automation. La "n", ocho letras en el medio, "n". En inglés se pronuncia "en-eight-en"; en la práctica en Argentina la gente dice directamente ene-ocho-ene. El logo son las letras n8n en coral. Ya lo vas a reconocer en todos lados.
n8n usa una licencia fair-code: el código fuente está disponible y podés leerlo, modificarlo y hostearlo vos mismo, pero no es 100% open source clásico porque tiene restricciones comerciales para proveedores de cloud. Para el 99% de los casos de uso —automatizar procesos propios o de tu organización— es completamente libre.
Tres formas de correrlo
Antes de abrir el editor, hay que elegir dónde va a vivir tu instancia de n8n. Hay tres caminos, y conviene pensarlos como un espectro de control vs. comodidad: de menos esfuerzo (la nube oficial) a más control (tu propio servidor), con un punto medio muy cómodo en el centro.
n8n Cloud
Alojado por n8n, de pago. Arrancás en minutos sin instalar nada: entrás a app.n8n.cloud, creás una cuenta y ya tenés tu editor online, con trial gratuito. Cero administración, pero el precio es el más alto y los datos viven en su infraestructura.
PikaPods 🦔
Self-hosting gestionado: es tu instancia (tus datos, tu base de datos), pero PikaPods administra el servidor, los backups y las actualizaciones por vos. Desde ~US$1,20/mes, online en menos de un minuto. El punto dulce entre un VPS y la nube oficial.
Auto-alojado (VPS)
Gratis (pagás solo el servidor). Lo corrés vos en tu propio VPS o máquina con Docker o npm. Control y personalización totales, pero sos vos quien administra todo: actualizaciones, backups, HTTPS, seguridad.
| n8n Cloud | PikaPods | VPS self-host | |
|---|---|---|---|
| Esfuerzo de setup | Nulo | Mínimo | Alto |
| Administración (updates, backups) | La hacen ellos | La hace PikaPods | La hacés vos |
| Tus datos en tu instancia | No | Sí | Sí |
| Control total / personalización | Limitado | Medio (env vars) | Total |
| Costo aprox. de entrada | ~US$20+/mes | ~US$1,20–5/mes | Costo del VPS |
| Ideal para | Equipos sin tiempo | Empezar en serio, barato | Técnicos con requisitos |
Para seguir los ejemplos paso a paso sin gastar nada, corré npx n8n en tu terminal o usá el trial de n8n Cloud: en segundos tenés el editor en http://localhost:5678. Y si después querés una instancia permanente y barata sin pelearte con un servidor, PikaPods es el camino más directo. Lo vemos en detalle ahora.
n8n en PikaPods: el punto medio, en detalle
PikaPods es un servicio de hosting gestionado para apps open source. Elegís n8n de su catálogo, apretás deploy, y en menos de un minuto tenés tu propia instancia corriendo con una URL HTTPS del tipo https://tu-pod.pikapod.net. No hace falta saber Docker ni tocar un servidor: PikaPods se encarga de la infraestructura, los backups diarios y las actualizaciones. Vos solo usás n8n y, cuando hace falta, ajustás sus variables de entorno.
Lo que PikaPods ya resuelve por vos
Acá está la gracia de la opción intermedia: varias de las variables que en un VPS tendrías que configurar a mano, PikaPods las deja listas. No las toques salvo que sepas lo que hacés.
Clave de cifrado (N8N_ENCRYPTION_KEY): se autogenera y se persiste en el volumen del pod, así que tus credenciales sobreviven a los reinicios. URL pública y webhooks (WEBHOOK_URL / host): ya apuntan a la dirección del pod, por lo que los webhooks funcionan de entrada. HTTPS, base de datos (SQLite persistente) y backups diarios: todo administrado.
Cómo cargar variables de entorno en PikaPods
Las variables de entorno son la forma en que se configura n8n por debajo: cada ajuste —zona horaria, idioma, permisos del nodo Code, limpieza de datos— es una variable CLAVE=valor. En PikaPods se editan desde el panel del pod:
Abrí la configuración del pod
En tu dashboard de PikaPods, hacé clic en el ícono de engranaje (settings) del pod de n8n.
Entrá a la pestaña ENV VARS
Vas a ver la lista de variables que PikaPods ya expone para n8n, cada una con un enlace a la documentación oficial que explica qué hace. Completá o editá los valores que necesites.
Guardá los cambios
Apretá Save. Importante: n8n lee las variables de entorno una sola vez, al arrancar, así que el cambio todavía no tiene efecto.
Reiniciá el pod
Desde More > Restart Pod. Recién ahí n8n vuelve a leer las variables y aplica la nueva configuración.
PikaPods precarga las env vars más comunes y útiles, pero no expone todas. Si necesitás una muy específica que no aparece en la lista, escribí a hello@pikapods.com y la agregan. No edites archivos por SFTP para esto: la vía correcta es la pestaña ENV VARS.
Variables que conviene configurar vos
Estas son las que más impacto tienen para un n8n recién montado en PikaPods. Empezá por la zona horaria —si no, los nodos de horario van a correr en hora de Nueva York, no la tuya.
| Variable | Para qué sirve | Valor de ejemplo |
|---|---|---|
GENERIC_TIMEZONE | Zona horaria que usan los nodos Schedule/Cron. Por defecto es America/New_York. | America/Argentina/Buenos_Aires |
TZ | Zona horaria del sistema y de los logs. Ponela igual que la anterior. | America/Argentina/Buenos_Aires |
N8N_DEFAULT_LOCALE | Idioma de la interfaz del editor. | es |
EXECUTIONS_DATA_PRUNE | Borra automáticamente las ejecuciones viejas. Clave para no llenar el almacenamiento del pod. | true |
EXECUTIONS_DATA_MAX_AGE | Cuántas horas se conservan las ejecuciones antes de borrarse (con prune activo). | 168 (7 días) |
N8N_RUNNERS_ENABLED | Activa los task runners, la forma recomendada de ejecutar código. Saca el warning de deprecación. | true |
NODE_FUNCTION_ALLOW_EXTERNAL | Permite importar paquetes npm externos dentro del nodo Code. La variable más pedida por los usuarios de n8n en PikaPods. | axios,lodash (o *) |
NODE_FUNCTION_ALLOW_BUILTIN | Permite usar módulos nativos de Node (como crypto) en el nodo Code. | crypto (o *) |
N8N_BLOCK_ENV_ACCESS_IN_NODE | Seguridad: evita que un workflow lea las variables de entorno del servidor. | true |
N8N_PERSONALIZATION_ENABLED | Saca la encuesta de personalización del primer arranque. | false |
N8N_DIAGNOSTICS_ENABLED | Apaga la telemetría anónima. | false |
En la pestaña ENV VARS cada una de estas es un campo. Si lo pensás como un archivo, se vería así:
# Zona horaria (lo primero que querés tocar)
GENERIC_TIMEZONE=America/Argentina/Buenos_Aires
TZ=America/Argentina/Buenos_Aires
# Mantener la base de datos liviana
EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168
# Habilitar paquetes en el nodo Code (si los vas a usar)
NODE_FUNCTION_ALLOW_EXTERNAL=axios,lodash
N8N_RUNNERS_ENABLED=trueEn PikaPods no necesitás generar N8N_ENCRYPTION_KEY: ya está y se persiste. Pero si algún día migrás tu n8n a otro lado (a un VPS, por ejemplo), llevate esa clave: sin ella, las credenciales guardadas quedan indescifrables y las tenés que volver a cargar todas a mano. Anotala en tu gestor de contraseñas el día que la necesites.
Arrancar n8n paso a paso
Elegí tu camino y seguí estos pasos. Todos terminan en el mismo lugar: el editor abierto en el navegador.
Elegí cómo correrlo
Cloud: abrí app.n8n.cloud y creá una cuenta. Tenés trial sin tarjeta. PikaPods: elegí n8n del catálogo, deploy, y entrás por la URL del pod. Local con npx: abrí una terminal y ejecutá npx n8n — descarga e inicia todo automáticamente. Local con Docker: docker run -it --rm -p 5678:5678 docker.n8n.io/n8nio/n8n.
Abrí el editor en el navegador
Si usás n8n local, navegá a http://localhost:5678. Si usás Cloud, ya estás ahí. La primera vez te va a pedir que crees una cuenta o usuario administrador.
Creá un workflow nuevo
En la pantalla principal vas a ver la lista de workflows (vacía por ahora). Hacé clic en "+ New workflow" o en el botón de crear. Se abre el canvas.
Conocé el canvas y el panel de nodos
El canvas es la grilla donde construís. Hacé clic en "+" o en "Add first step" para abrir el panel de nodos: ahí están todas las integraciones y acciones disponibles. Explorá un poco; no rompés nada.
Guardá (sin activar todavía)
Arriba del canvas encontrás el nombre del workflow (podés editarlo), el botón Save y el toggle Active. Guardá siempre. Dejá el toggle en inactivo mientras estás desarrollando; lo activás recién cuando el workflow está listo para correr en producción.
Tour rápido por el editor
Antes de construir el primer workflow, conviene saber qué es cada cosa que aparece en pantalla.
La grilla
Es el espacio de trabajo. Acá arrastras nodos, los conectás y ves el flujo completo. Podés hacer zoom, mover el viewport y reorganizar todo libremente.
Las piezas
Se abre con el botón "+" o "Add first step". Muestra todos los nodos disponibles: triggers, acciones, lógica. Buscás por nombre de servicio o por categoría.
Las credenciales
Tokens, contraseñas y API keys se guardan aparte y cifradas, separadas del workflow. Así podés compartir un workflow sin exponer tus claves.
Historial de ejecuciones
La pestaña Executions muestra cada vez que corrió el workflow: cuándo fue, si salió bien o falló, y qué data pasó por cada nodo. Fundamental para debuggear.
Inactivo mientras desarrollás
El toggle de la barra superior activa o desactiva el workflow. Un workflow inactivo no se dispara automáticamente aunque lleguen eventos. Activalo solo cuando está probado.
Cómo se conectan los nodos
La mecánica de conexión es simple y es el corazón del editor: cada nodo tiene un puntito de salida en el lado derecho. Arrastrás desde ese punto hasta la entrada del siguiente nodo; aparece una línea que es la conexión por donde va a viajar la data.
Cada nodo procesa la data que recibe y la pasa al siguiente. Si un nodo falla, el flujo se detiene ahí y queda registrado en Executions. Podés tener múltiples ramas saliendo de un mismo nodo —lo vemos en la sección de anatomía.
Cuando configurás un nodo que necesita autenticarse (Gmail, Slack, Notion, lo que sea), n8n te pide que crees una Credential. Esa credencial se guarda cifrada en la base de datos de n8n, separada del workflow. Si exportás o compartís el workflow, las claves no viajan con él. Esto es un diseño deliberado y está muy bien pensado.
Ya estás adentro del editor. Sabés qué es el canvas, cómo se conectan los nodos y dónde viven las credenciales. Lo que sigue es entender de qué está hecho un workflow por dentro: qué son exactamente los nodos, qué es la data que fluye entre ellos y cómo leerla. Eso es la Sección 05.