Distribuzione locale di n8n

Distribuisci n8n localmente su Linux/macOS, installa il nodo community di CometAPI e configura le credenziali API per eseguire workflow automatizzati sulla tua macchina.

Distribuisci n8n sulla tua macchina e collegalo a CometAPI tramite il nodo community per eseguire localmente workflow AI automatizzati.

​

Prerequisiti

• Linux (Ubuntu/Debian/CentOS, ecc.) o macOS
• 2 GB+ di RAM, 10 GB+ di spazio libero su disco
• Accesso alla shell con accesso al registro npm pubblico
• Node.js 18.x o 20.x LTS (vedi Passaggio 1)
• Un account CometAPI con una chiave API attiva — ottienila qui

1. Ottieni la tua chiave API CometAPI

   Accedi alla console CometAPI. Fai clic su Add API Key e copia la tua chiave sk-xxxxx.

   

   
2. Installa Node.js tramite nvm

   n8n 1.x richiede Node.js 18.x o 20.x. L’approccio consigliato è 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
   

   Se in seguito vedi n8n: command not found, riavvia il terminale oppure assicurati che la directory bin globale di npm gestita da nvm sia nel tuo PATH.

3. Installa e avvia n8n

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

   Se la porta 5678 è già in uso:

   export N8N_PORT=5679
   n8n start
   

   Per mantenere n8n in esecuzione dopo aver chiuso il terminale:

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

   

   
4. Crea il tuo account owner

   Apri http://localhost:5678/ nel browser. Al primo avvio, la procedura guidata di configurazione ti chiede di creare un account Owner (email + password). Completa questo passaggio e accedi.

   
5. Installa il nodo community di CometAPI

   1. Vai su Settings (in basso a sinistra) → Community nodes
   2. Fai clic su Install a community node
   3. Inserisci il nome del pacchetto: @cometapi-dev/n8n-nodes-cometapi
   4. Seleziona la casella di accettazione del rischio e fai clic su Install

   Dopo l’installazione puoi cercare CometAPI nel pannello dei nodi.

   

   

   Se la sezione Community Nodes non è presente: assicurati di aver effettuato l’accesso con l’account Owner e controlla in Settings → Security per confermare che l’installazione dei community node sia abilitata.

6. Crea un workflow e configura le credenziali

   1. Fai clic su + New in alto per creare un workflow.
   2. Fai clic su + nel canvas e cerca CometAPI per aggiungere il nodo.

   

   

   3. Aggiungi un nodo Manual Trigger e collegalo al nodo CometAPI.
   4. Nel nodo CometAPI, sotto Credential to connect with, scegli Create new. Incolla la tua chiave sk-xxxxx in CometAPI Key e fai clic su Save. Il Base URL è impostato di default su https://api.cometapi.com e in genere non richiede modifiche.

   

   5. Configura il nodo:

   • Model: inserisci l’ID del modello corrente che vuoi usare
   • Messages: imposta Role su user, Content sul tuo prompt di test (ad esempio Hello)
   • Facoltativo: aggiungi un messaggio system, imposta Max Tokens, Temperature, ecc.

   6. Fai clic su Execute step per eseguire il nodo. Il pannello Output mostra la risposta JSON.

   

Risoluzione dei problemi

• Errori node-gyp o di build nativa — installa gli strumenti di build: sudo apt install build-essential python3 (Debian/Ubuntu) oppure Xcode Command Line Tools (macOS).
• Errori di permessi npm (EACCES) — usa nvm per un’installazione di Node.js a livello utente; non serve sudo.
• Conflitto di porta (localhost:5678 non disponibile) — imposta N8N_PORT=5679 (o un’altra porta libera) prima di eseguire n8n start.
• Sezione Community Nodes mancante — accedi con l’account Owner e controlla Settings → Security.
• npm install non riesce su reti aziendali — configura un proxy: npm config set proxy http://user:pass@host:port
• Il nodo CometAPI restituisce 401/403 — verifica la tua chiave API e che il modello sia accessibile nel tuo piano CometAPI.
• Risposte vuote o errori di limite token — aumenta Max Tokens; regola Temperature e Top P secondo necessità.
• n8n si arresta quando il terminale viene chiuso — usa pm2: pm2 start "n8n" --name n8n && pm2 save.