Despliegue local de n8n

Despliega n8n localmente en Linux/macOS, instala el nodo comunitario de CometAPI y configura las credenciales de API para ejecutar flujos de trabajo automatizados en tu máquina.

Despliega n8n en tu propia máquina y conéctalo a CometAPI mediante el nodo comunitario para ejecutar localmente flujos de trabajo automatizados de IA.

​

Prerrequisitos

• Linux (Ubuntu/Debian/CentOS, etc.) o macOS
• 2 GB+ de RAM, 10 GB+ de espacio libre en disco
• Acceso al shell con alcance al registro público de npm
• Node.js 18.x o 20.x LTS (consulta el Paso 1)
• Una cuenta de CometAPI con una API key activa — obtén la tuya aquí

1. Obtén tu API key de CometAPI

   Inicia sesión en la consola de CometAPI. Haz clic en Add API Key y copia tu clave sk-xxxxx.

   

   
2. Instala Node.js mediante nvm

   n8n 1.x requiere Node.js 18.x o 20.x. El enfoque recomendado es nvm:

   # Install nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   
   # Reload your shell profile
   source ~/.bashrc   # or ~/.zshrc on macOS
   
   # Install and activate the LTS version
   nvm install --lts
   nvm use --lts
   
   # Verify
   node -v
   npm -v
   

   Si más adelante ves n8n: command not found, reinicia la terminal o asegúrate de que el directorio global bin de npm administrado por nvm esté en tu PATH.

3. Instala e inicia n8n

   npm install -g n8n
   n8n -v       # verify the installed version
   n8n start    # runs on http://localhost:5678/
   

   Si el puerto 5678 ya está en uso:

   export N8N_PORT=5679
   n8n start
   

   Para mantener n8n en ejecución después de cerrar la terminal:

   npm install -g pm2
   pm2 start "n8n" --name n8n
   pm2 save
   pm2 status
   

   

   
4. Crea tu cuenta de propietario

   Abre http://localhost:5678/ en tu navegador. En la primera ejecución, el asistente de configuración te pide crear una cuenta Owner (correo electrónico + contraseña). Completa este paso e inicia sesión.

   
5. Instala el nodo comunitario de CometAPI

   1. Ve a Settings (abajo a la izquierda) → Community nodes
   2. Haz clic en Install a community node
   3. Introduce el nombre del paquete: @cometapi-dev/n8n-nodes-cometapi
   4. Marca la casilla de reconocimiento de riesgo y haz clic en Install

   Después de la instalación, puedes buscar CometAPI en el panel de nodos.

   

   

   Si falta la sección Community Nodes: asegúrate de haber iniciado sesión con la cuenta Owner, y revisa Settings → Security para confirmar que la instalación de nodos comunitarios está habilitada.

6. Crea un workflow y configura las credenciales

   1. Haz clic en + New en la parte superior para crear un workflow.
   2. Haz clic en + en el lienzo y busca CometAPI para agregar el nodo.

   

   

   3. Agrega un nodo Manual Trigger y conéctalo al nodo de CometAPI.
   4. En el nodo de CometAPI, en Credential to connect with, elige Create new. Pega tu clave sk-xxxxx en CometAPI Key y haz clic en Save. La Base URL por defecto es https://api.cometapi.com y normalmente no necesita cambios.

   

   5. Configura el nodo:

   • Model: introduce el ID del modelo actual que quieres usar
   • Messages: establece Role en user, Content con tu prompt de prueba (por ejemplo, Hello)
   • Opcional: agrega un mensaje system, configura Max Tokens, Temperature, etc.

   6. Haz clic en Execute step para ejecutar el nodo. El panel Output muestra la respuesta JSON.

   

Solución de problemas

• Errores de node-gyp o de compilación nativa — instala las herramientas de compilación: sudo apt install build-essential python3 (Debian/Ubuntu) o Xcode Command Line Tools (macOS).
• Errores de permisos de npm (EACCES) — usa nvm para una instalación de Node.js a nivel de usuario; no se necesita sudo.
• Conflicto de puertos (localhost:5678 no disponible) — configura N8N_PORT=5679 (u otro puerto libre) antes de ejecutar n8n start.
• Falta la sección Community Nodes — inicia sesión con la cuenta Owner y revisa Settings → Security.
• npm install falla en redes corporativas — configura un proxy: npm config set proxy http://user:pass@host:port
• El nodo de CometAPI devuelve 401/403 — verifica tu API key y que el modelo esté accesible en tu plan de CometAPI.
• Respuestas vacías o errores de límite de tokens — aumenta Max Tokens; ajusta Temperature y Top P según sea necesario.
• n8n se detiene al cerrar la terminal — usa pm2: pm2 start "n8n" --name n8n && pm2 save.