n8n sul tuo server

n8n è uno strumento di automazione che collega le app e ti permette di creare workflow. Puoi farlo girare sul tuo VPS con Docker. La documentazione ufficiale illustra un'installazione con Docker Compose e consiglia l'hosting autonomo a chi ha esperienza tecnica. Le guide all'installazione non indicano nessun valore per CPU, RAM o disco, quindi ha senso partire con un server piccolo e ingrandire osservando l'uso.

Questo articolo tratta la licenza, i passaggi dell'installazione, le impostazioni importanti, i backup e gli aggiornamenti.

Cosa si costruisce con n8n?

Un workflow in n8n è un trigger più i passaggi collegati. Il trigger può essere una pianificazione, un webhook o un evento in un'altra app. Esempi tipici: scrivere in un foglio di calcolo l'invio di un modulo, avvisare il team di un nuovo ordine, o raccogliere un report ogni mattina e inviarlo per email. I workflow si costruiscono in un editor visuale nel browser. Non serve scrivere codice, ma puoi aggiungere un passaggio di codice se vuoi.

Perché farlo girare sul tuo server?

• I tuoi workflow e i dati di connessione salvati restano sul tuo server.
• I workflow pianificati continuano a girare sul server anche con il tuo computer spento e i webhook possono avviarli dall'esterno.
• Il tuo limite di utilizzo lo stabilisce la potenza del tuo server e, se non basta, lo ingrandisci.
• In cambio la manutenzione è tua: aggiornamenti, backup e sicurezza.

Licenza: cosa permette l'uso gratuito?

n8n non è open source. Per sua stessa definizione è software "fair-code". Il sorgente è disponibile, ma la Sustainable Use License limita l'uso commerciale. Secondo la pagina ufficiale della licenza, puoi usarlo gratuitamente per le attività interne della tua azienda e per progetti personali o non commerciali. Va bene anche creare workflow per i clienti come consulenza a pagamento, purché i clienti non abbiano accesso a n8n. Offrire un servizio in cui i clienti accedono a n8n per creare o modificare i propri workflow (ospitare n8n come servizio) richiede una licenza commerciale. Per i casi dubbi, chiedi al team licenze di n8n.

Passaggi dell'installazione

Questi passaggi seguono la guida ufficiale a Docker Compose. La guida ottiene e rinnova il certificato HTTPS tramite un reverse proxy chiamato Traefik.

1. Prepara un server Linux con Docker Engine e Docker Compose installati. Controlla con docker --version e docker compose version.
2. Aggiungi un record A che faccia puntare un sottodominio del tuo dominio (per esempio n8n.example.com) all'indirizzo IP del server. Come collegare il tuo dominio ti guida nei passaggi.
3. Crea sul server i file .env e compose.yaml della guida ufficiale.
4. Compila DOMAIN_NAME, SUBDOMAIN, GENERIC_TIMEZONE e SSL_EMAIL in .env. Per il fuso orario usa Europe/Istanbul. Se lo ometti, il valore predefinito è New York.
5. Avvialo: docker compose up -d
6. Apri il tuo sottodominio in un browser e crea subito l'account proprietario. Chi compila per primo quella schermata diventa il proprietario.

Impostazioni da conoscere

Il nodo Webhook ha due indirizzi: quello di test funziona mentre modifichi il workflow, quello di produzione funziona dopo che lo attivi. Ai servizi esterni dai l'indirizzo di produzione. L'inizio dell'indirizzo deriva dal valore di N8N_WEBHOOK_URL, quindi se quel valore è sbagliato i servizi esterni non raggiungono il tuo workflow.

La chiave di cifratura e i backup

Al primo avvio n8n genera una chiave di cifratura casuale e la tiene nella sua cartella dati (/home/node/.n8n). Le tue connessioni salvate sono cifrate con essa. I dati di connessione in un database ripristinato non si possono decifrare senza la chiave. Tieni una copia separata della chiave.

• Cosa salvare: il volume dei dati (n8n_data) contiene il database SQLite predefinito e la chiave. Ferma n8n prima di copiare. Se usi PostgreSQL, fai il backup del database a parte con i suoi strumenti.
• Esportazione rapida: i comandi di n8n girano dentro il container. docker compose exec n8n n8n export:workflow --backup --output=/home/node/.n8n/backups/workflows/ e docker compose exec n8n n8n export:credentials --backup --output=/home/node/.n8n/backups/credentials/ scrivono workflow e connessioni nel volume dei dati. Utenti, cronologia delle esecuzioni e impostazioni non sono inclusi, quindi non basta per un ripristino completo.
• Backup del server: Seturack fa il backup del tuo server ogni notte e conserva gli ultimi 7 giorni. Comprende anche i dati di n8n, ma esportare a parte i workflow critici è una buona idea.

Risorse e database

Le guide ufficiali all'installazione non indicano nessun valore di CPU o memoria. Come regola pratica, i workflow leggeri e poco frequenti girano su un server piccolo, mentre quelli che gestiscono file grandi o molti dati richiedono memoria. Osserva l'uso reale del container con docker stats. Il database predefinito è SQLite. Per un uso intenso passi a PostgreSQL con DB_TYPE=postgresdb, mantenendo comunque il volume della cartella dati.

Se il server non basta, ingrandiscilo dal pannello. Il tuo indirizzo IP e i tuoi dati restano gli stessi e gli URL dei webhook non cambiano.

Aggiornare

La guida ufficiale descrive l'aggiornamento in tre comandi: docker compose pull, docker compose down e docker compose up -d. Fai prima un backup e leggi le note di rilascio. Dopo la configurazione, gli aggiornamenti del sistema operativo e delle applicazioni sono tuoi.

Sicurezza

• Apri n8n solo via HTTPS. La guida ufficiale segue lo stesso approccio.
• Crea l'account proprietario subito dopo la configurazione e scegli una password robusta.
• Tieni aperte nel firewall solo le porte 22, 80 e 443. Poiché Docker salta le regole ufw per le porte che pubblica, non pubblicare all'esterno la porta 5678 di n8n.

Se preferisci saltare questi passaggi, scegli il tuo server con n8n preinstallato. Se lo installi tu, parti da un server con Docker installato.