Comandos esenciales del CLI de n8n para automatización

Clase 3 de 13 • Curso de n8n Self-Hosted para Empresas

Clase anteriorSiguiente clase

Resumen

Administrar n8n sin abrir el navegador es rápido y confiable con su CLI oficial. Con el Command Line Interface podrás ejecutar workflows, exportarlos, importar credentials y resetear usuarios desde la terminal. Ideal para automatizar tareas administrativas, hacer backups, integrarlo con GitHub Actions o acelerar despliegues.

¿Qué es el CLI de n8n y para qué sirve?

Permite operar n8n desde la terminal, tanto si instalas con NPM como si corres en Docker. No necesitas la interfaz gráfica para acciones clave.

  • Ejecutar y listar workflows.
  • Exportar e importar workflows y credentials.
  • Reiniciar el owner en emergencias con user-management.
  • Integrar con scripts y procesos de CI/CD.

¿Qué diferencia hay entre usar NPM y Docker?

  • Con NPM: instalas n8n de forma global en tu máquina y lo ejecutas con un único comando.
  • Con Docker: levantas un contenedor mapeando el puerto por defecto de n8n, 5678, y accedes desde tu navegador.
  • Si cierras Docker y luego arrancas con NPM, verás una instancia “nueva”. n8n guarda datos en la carpeta oculta .n8n por defecto; ahí viven configuración, base de datos SQLite, nodos y conexión por SSH.

¿Cómo instalar n8n con NPM o Docker?

Instala por el método que prefieras y valida que todo corre bien antes de crear workflows de prueba.

  • Verificar Node:
node --version
  • Instalar n8n con NPM de forma global:
npm install -g n8n
n8n --version
n8n
  • Verificar Docker:
docker version
  • Ejecutar n8n en Docker (modo interactivo y puerto por defecto 5678):
docker run -it -p 5678:5678 n8n.io/n8n
  • Completar el registro en la URL local. Puedes saltar la licencia de prueba si no la necesitas.
  • Crear un workflow simple: un trigger manual y un node tipo Set o Edit Fields. Guardar con un nombre claro.
  • Crear un credential genérico para pruebas.

¿Cómo crear y reutilizar un workflow con JSON?

  • Todos los flujos en n8n son JSON.
  • Puedes copiar un JSON válido y pegarlo en el canvas para crear el workflow.
  • Útil cuando generas el JSON con herramientas de IA y lo pegas directamente.

¿Qué comandos del CLI son imprescindibles?

Con el CLI puedes consultar, exportar y recuperar el acceso a tu instancia. Estos son los comandos demostrados paso a paso.

  • Ayuda general:
n8n --help
  • Listar workflows:
n8n list:workflow
  • Exportar un workflow por su ID a un archivo JSON. Si no indicas ID, exporta todos.
n8n export:workflow --id=TU_ID --output=workflow.json

  • Verificar el archivo exportado y abrir su contenido. Si el JSON contiene un arreglo y necesitas un solo flujo, copia solo el objeto del flujo y pégalo en el canvas.

  • Resetear el owner en caso de olvidar correo o contraseña:

n8n user-management reset

  • Después del reset: detener y reiniciar el servidor de n8n. Al recargar, crea un usuario nuevo. Importante: los workflows y credentials permanecen.

  • Buenas prácticas sugeridas: exportar workflows y credentials de una instancia y luego importarlos en otra. Útil para migraciones y pruebas.

¿Ya exportaste tus workflows y credentials y probaste a borrarlos e importarlos de vuelta? Cuéntame en comentarios si te funcionó y qué reto te encontraste.