Resumen rápido: Ejecutar n8n localmente requiere npm (Node.js 20.19-24.x) o Docker. El método más rápido utiliza npx n8n para pruebas inmediatas sin instalación, mientras que Docker proporciona un mejor aislamiento y preparación para producción. Ambos métodos le dan acceso completo a las capacidades de automatización de flujos de trabajo de n8n sin costos recurrentes en la nube.
Configurar n8n en una máquina local elimina las tarifas de suscripción recurrentes y proporciona control total sobre la automatización de flujos de trabajo. Según la documentación oficial de n8n, la plataforma requiere una versión de Node.js entre 20.19 y 24.x para instalaciones npm, o Docker para implementaciones contenerizadas.
La decisión entre alojamiento local y servicios en la nube afecta tanto al presupuesto como a la flexibilidad. Según las discusiones de la comunidad, las instalaciones locales manejan flujos de trabajo ilimitados, mientras que los planes en la nube incluyen precios basados en la ejecución (a partir de $24/mes por 2,500 ejecuciones según algunos informes de usuarios).
Prerrequisitos para la Instalación Local
Antes de instalar n8n localmente, el sistema necesita software específico dependiendo del método elegido.
La versión requerida de Node.js para una instalación npm depende completamente de los requisitos específicos de la versión de n8n que esté implementando, ya que npm en sí es compatible con todas las versiones LTS compatibles actualmente de Node.js. La documentación oficial especifica este rango de versiones exacto para compatibilidad. Verifique la versión actual ejecutando node –version en la terminal.
Las instalaciones de Docker requieren Docker Engine o Docker Desktop. El equipo de n8n recomienda Docker para la mayoría de las necesidades de auto-alojamiento porque proporciona un aislamiento limpio y evita incompatibilidades del sistema operativo.
Requisitos del Sistema
Las instancias locales de n8n se ejecutan en sistemas Windows, macOS y Linux. No hay una especificación mínima de RAM en la documentación oficial, pero la complejidad del flujo de trabajo determina las necesidades reales de recursos.
La instalación consume un espacio mínimo en disco inicialmente. Los requisitos de almacenamiento crecen según los datos del flujo de trabajo, el historial de ejecución y los paquetes de nodos personalizados.
Método 1: Ejecutar n8n con npm
La instalación npm proporciona el camino más rápido para ejecutar n8n localmente. Este método funciona directamente en el sistema anfitrión sin contenerización.
Inicio Rápido con npx
El enfoque más simple utiliza npx sin instalación permanente. Abra una terminal y ejecute:
| npx n8n |
Este comando descarga todo lo necesario e inicia n8n automáticamente. La interfaz se vuelve accesible en localhost:5678 en segundos.
El método npx funciona perfectamente para pruebas y evaluación. No requiere paquetes npm globales ni cambios permanentes en el sistema.
Instalación Global de npm
Para la instalación permanente, el paquete npm global proporciona acceso consistente:
| npm install n8n -g |
Una vez completada la instalación, inicie n8n en cualquier momento ejecutando:
| n8n |
La versión estable principal actual de n8n es la 2.x (por ejemplo, 2.10.4). Las versiones beta pueden contener características inestables y deben evitarse para flujos de trabajo de producción.
Configuración y Almacenamiento de Datos
Las instalaciones npm almacenan los datos del flujo de trabajo en el directorio ~/.n8n por defecto. Esta ubicación contiene credenciales, definiciones de flujos de trabajo e historial de ejecución.
Las variables de entorno controlan el comportamiento de n8n. Establezca la variable N8N_PORT para cambiar el puerto predeterminado 5678. Otras variables configuran conexiones de base de datos, URL de webhooks y ajustes de autenticación.
Método 2: Ejecutar n8n con Docker
La instalación de Docker representa el enfoque recomendado para el alojamiento local de n8n. La documentación oficial enfatiza Docker para necesidades de auto-alojamiento de producción.
Comando Básico de Ejecución de Docker
Inicie n8n con un solo comando Docker:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Este comando crea un contenedor llamado n8n, mapea el puerto 5678 al host y persiste los datos en el directorio ~/.n8n.
El contenedor se ejecuta interactivamente con la bandera -it. Elimine –rm para mantener el contenedor después de detenerlo.
Docker Compose para Configuración de Producción
Las configuraciones de Docker Compose proporcionan un mejor control para entornos de producción. El repositorio n8n-hosting en GitHub contiene archivos Docker Compose listos para usar para varias arquitecturas.
Una configuración básica de docker-compose.yml se ve así:
| version: ‘3.8’ services: n8n: image: n8nio/n8n restart: always ports: – “5678:5678” environment: – N8N_BASIC_AUTH_ACTIVE=true – N8N_BASIC_AUTH_USER=admin – N8N_BASIC_AUTH_PASSWORD=password volumes: – ~/.n8n:/home/node/.n8n |
Inicie la pila con:
| docker-compose up -d |
La bandera -d ejecuta los contenedores en modo independiente, permitiendo el uso de la terminal para otras tareas.
Configuración Inicial y Acceso
Después de iniciar n8n a través de cualquiera de los métodos, navegue a localhost:5678 en un navegador web. La pantalla de configuración inicial solicita una dirección de correo electrónico y una contraseña para la cuenta de administrador.
Este primer usuario se convertirá en el propietario de la instancia con privilegios administrativos completos. Los usuarios adicionales se pueden agregar más tarde a través de la interfaz de administración de usuarios.
Configuración de Autenticación
Por seguridad, habilite la autenticación incluso en instalaciones locales. Las configuraciones de Docker Compose aceptan variables de entorno de autenticación directamente:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Estas variables activan la autenticación básica HTTP, requiriendo credenciales para todos los intentos de acceso.
Prueba de Nodos Personalizados Localmente
La documentación oficial explica cómo probar nodos personalizados durante el desarrollo. Primero, instale n8n globalmente, luego compile y enlace el paquete de nodo personalizado.
En el directorio del nodo personalizado, ejecute:
| npm run build npm link |
Luego, navegue al directorio de nodos de n8n (típicamente ~/.n8n/custom/) y enlace el paquete:
| npm link <node-package-name> |
El nodo personalizado aparecerá en la interfaz de n8n después de reiniciar la instancia.
Recursos de Automatización Útiles para Usar con n8n
Si está aprendiendo a ejecutar n8n localmente y probando flujos de trabajo en su máquina, también puede beneficiarse de ayudantes y plantillas externas que facilitan la automatización de tareas comunes. Get AI Perks ofrece una biblioteca de plantillas de flujos de trabajo y herramientas asistidas por IA que puede usar junto con n8n o para prototipar ideas de automatización antes de construirlas usted mismo.
Con Get AI Perks, puede:
- Comenzar con plantillas de flujos de trabajo preconstruidas
- Obtener asistencia de IA para lógica y contenido de rutina
- Explorar patrones de automatización comunes antes de implementarlos en n8n
- Combinar plantillas con su configuración local de n8n
Descubra Get AI Perks para encontrar ayudantes de automatización que respalden sus flujos de trabajo de n8n.
Solución de Problemas Comunes
Los conflictos de puertos representan el problema de instalación más frecuente. Si el puerto 5678 ya está en uso, detenga el servicio conflictivo o cambie el puerto de n8n utilizando la variable de entorno N8N_PORT.
Incompatibilidad de Versión de Nodo
El uso de versiones de Node.js fuera del rango 20.19-24.x causa fallos en la instalación. El repositorio de GitHub de n8n documenta problemas cuando los desarrolladores intentan entornos de desarrollo locales, destacando la importancia de la compatibilidad de la versión de Node.
Verifique la compatibilidad de la versión de Node antes de solucionar otros problemas. Cambie las versiones de Node usando nvm (Node Version Manager) si es necesario.
Errores de Permiso de Volumen de Docker
Los problemas de permisos con el montaje de volumen ~/.n8n impiden la persistencia de datos. Los contenedores de Docker se ejecutan como el usuario de nodo, que podría carecer de acceso de escritura al directorio anfitrión.
Cree el directorio con los permisos apropiados antes de iniciar el contenedor:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Preguntas Frecuentes
¿Puede n8n ejecutarse sin acceso a Internet?
Sí, n8n funciona completamente sin conexión para flujos de trabajo locales. La conectividad a Internet solo se vuelve necesaria cuando los flujos de trabajo interactúan con API externas o servicios en la nube.
¿Cuánto cuesta ejecutar n8n localmente?
Las instalaciones locales son gratuitas. La edición comunitaria proporciona todas las características principales sin tarifas de licencia. El alojamiento en la nube comienza con límites de ejecución y costos mensuales, pero el alojamiento local elimina estas restricciones por completo según las discusiones de la comunidad.
¿Deben los principiantes usar npm o Docker?
Los principiantes que prueban n8n deben comenzar con npx para un acceso inmediato. Docker tiene más sentido para un uso continuo porque proporciona un mejor aislamiento y actualizaciones más fáciles.
¿Dónde almacena n8n los datos del flujo de trabajo localmente?
El directorio de datos predeterminado es ~/.n8n en la carpeta principal del usuario. Esta ubicación contiene archivos de base de datos SQLite, credenciales y registros de ejecución, a menos que se configure de otra manera.
¿Se pueden ejecutar varias instancias de n8n en una sola máquina?
Sí, pero cada instancia necesita un puerto único. Establezca puertos diferentes usando la variable de entorno N8N_PORT para cada instancia. Docker facilita esto a través del mapeo de puertos en contenedores separados.
¿Cómo funcionan las actualizaciones para instalaciones locales?
Las instalaciones npm se actualizan a través de npm update -g n8n o npm install -g n8n@latest. Los usuarios de Docker extraen la última imagen con docker pull n8nio/n8n, y luego recrean los contenedores. Siempre haga una copia de seguridad del directorio ~/.n8n antes de actualizar.
Consideraciones de Producción
La documentación oficial de n8n enfatiza que el auto-alojamiento requiere conocimiento técnico. Configurar servidores, administrar recursos y asegurar aplicaciones exige experiencia con administración de sistemas.
Para implementaciones de producción, Docker Compose proporciona la base. Agregue un proxy inverso como nginx o Caddy para soporte HTTPS. El repositorio n8n-hosting incluye configuraciones de Caddy listas para implementar.
La selección de la base de datos es importante para cargas de trabajo pesadas. La base de datos SQLite predeterminada funciona para uso moderado, pero PostgreSQL ofrece un mejor rendimiento para automatización de alto volumen según la guía oficial.
Tomando la Decisión: Local vs. Nube
El alojamiento local de n8n se adapta a equipos con capacidades técnicas y requisitos de seguridad específicos. Los datos permanecen en infraestructura controlada y los límites de ejecución desaparecen.
Sin embargo, el alojamiento local requiere mantenimiento, copias de seguridad y monitoreo. El alojamiento en la nube transfiere estas responsabilidades al equipo de infraestructura de n8n. Consulte el sitio web oficial para conocer los precios actuales en la nube y las comparaciones de características.
Ejecutar n8n localmente proporciona control total sobre la infraestructura de automatización de flujos de trabajo. Ya sea utilizando npm para pruebas rápidas o Docker para implementaciones de producción, ambos métodos ofrecen la plataforma completa sin costos recurrentes. Comience con npx para una exploración inmediata, luego transicione a Docker cuando los flujos de trabajo se muevan hacia el uso de producción.
