Vai al contenuto

Self-hosting n8n skill

Distribuisci e mantieni n8n con Docker, HTTPS Caddy, servizi privati e backup verificati.

Community · Romuald Członkowski
AutoreRomuald Członkowski
LicenzaMIT
Fonteczlonkowski/n8n-skills · SKILL.md su GitHub
Sito del progettodocs.n8n.io/deploy/host-n8n
Funziona inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Letta dalla fonte il

n8n-self-hosting guida l’agente da una nuova VM Linux a un’istanza n8n HTTPS con Docker Compose e Caddy.

Distingue istanza singola SQLite e modalità coda con Postgres, Redis ed esecutori esterni abbinati. È una skill operativa, non un creatore di workflow.

Dallo SKILL.md della skill: # Deploying self-hosted n8n

Questa è una skill della community di Romuald Członkowski, non verificata da noi né da Anthropic. Le skill possono dire all'agente di eseguire codice, leggere file o accedere alla rete. Prima di installarla, leggi il suo SKILL.md e ogni script nella cartella, e cerca qualsiasi cosa che non corrisponda a ciò che dichiara di fare.

Cosa fa

  1. Raccogli modalità, dominio, SSH e fuso orario prima del provisioning.
  2. Genera segreti sul server e mantieni privati i servizi interni.
  3. Verifica integrità, TLS e worker; documenta backup e ripristino.

Cosa ottieni

  • Configurazione Compose, Caddyfile e file di ambiente privato.
  • Verifiche di distribuzione e consegna delle procedure di manutenzione.

Quando usarla

  • Distribuire n8n su un server Linux autorizzato.
  • Correggere configurazioni di esecutori Python o worker di coda.

Quando non usarla

  • Creare workflow o amministrare n8n Cloud.

Cosa richiede

  • VM Linux, SSH root o sudo, DNS del dominio e porte pubbliche 80/443.
  • Docker Compose e Caddy; hosting, domini e funzioni n8n a pagamento hanno costi separati.

File della skill

File o cartellaA cosa serve
SKILL.mdScelta modalità e sequenza di distribuzione.
TASK_RUNNERS.mdConfigurazione esecutori esterni Python e JavaScript.
DAY2.mdProcedure di aggiornamento, backup e ripristino.
assets/Modelli Compose singolo e coda, Caddy e ambiente.

Licenza trovata nel repository il 2026-11-17: MIT.

Prompt di esempio

Scrivine uno dopo l'installazione; nominare la skill fa sì che venga usata.

  • Pianifica un’istanza singola sulla mia VM Linux; controlla DNS e accesso prima di modificarla.
  • Rivedi la distribuzione in coda per parità degli ambienti worker ed esecutori esterni abbinati.
  • Scrivi una lista di backup e ripristino che conservi la chiave di cifratura n8n.

Come installare n8n-self-hosting

Accesso al server

La cartella individuale richiede SSH e operazioni di sistema. Caricamento Claude.ai e percorso API in sandbox non sono verificati per questo workflow.

Il plugin n8n completo aggiunge routing e hook. Copia solo questa cartella per la guida operativa senza installare l’intero pacchetto.

Una skill è una cartella con un file SKILL.md. La installi una volta sola; l'agente legge la sua breve descrizione all'inizio di ogni sessione e carica le istruzioni complete solo quando una richiesta corrisponde. Scegli dove la usi:

Claude Code: copia la cartella nella tua cartella delle skill

Metti la cartella della skill in ~/.claude/skills/ per usarla in tutti i progetti su questo computer, oppure in .claude/skills/ dentro un repository per condividerla con chiunque ci lavori (fanne il commit).

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-self-hosting ~/.claude/skills/

Claude Code rileva le skill nuove o modificate in queste cartelle durante la sessione. Se la cartella delle skill non esisteva quando è iniziata la sessione, esegui una volta /reload-skills. Poi digita /n8n-self-hosting o descrivi semplicemente il compito.

Su Windows, esegui i comandi in Git Bash o WSL, oppure copia la cartella nello stesso percorso con Esplora file.

Codex, Gemini CLI, Cursor e GitHub Copilot

Questi agenti leggono le stesse cartelle SKILL.md. L'unica cartella di progetto accettata da tutti e quattro è .agents/skills/, quindi questo comando ci copia la skill:

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-self-hosting .agents/skills/
AgenteCartella del progettoLa tua cartella utenteNote
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digita $ o esegui /skills per scegliere una skill; Codex ne sceglie una anche da solo quando il tuo compito corrisponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Oppure installa da Git con gemini skills install <git URL> --path <folder> --consent. Il 18 giugno 2026 Google ha sostituito Gemini CLI con Antigravity CLI per gli utenti del piano gratuito e di Google One; Antigravity usa .agents/skills/ in un progetto e ~/.gemini/config/skills/ per te.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digita / nella chat Agent per scegliere una skill. Cursor legge anche le cartelle .claude/skills/ di Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funziona in Copilot CLI, nel cloud agent e nella modalità agente di VS Code, Visual Studio e JetBrains (il supporto negli IDE dipende dalla versione). Oppure esegui gh skill install OWNER/REPOSITORY SKILL (anteprima pubblica, GitHub CLI 2.90.0 o successiva).
Installa solo skill di cui ti fidi. Anthropic consiglia di usare solo skill di fonti affidabili e di leggere ogni file di qualsiasi altra skill prima di usarla: una skill può indurre l'agente a eseguire comandi, leggere file o inviare dati in modi che la sua descrizione non menziona.

Fonti per questi passaggi

Verificati sulla documentazione di ciascun fornitore il 2026-11-14:

Limiti operativi

Rivedi destinazione, finestra di manutenzione e backup prima di eseguire comandi su istanze esistenti. I modelli sono punti di partenza, non prove di integrità del server.

n8n auto-ospitato ha edizioni e licenze proprie, separate da questa skill con licenza MIT.

Domande su n8n-self-hosting

Richiede n8n-mcp?

La distribuzione usa SSH e Docker. n8n-mcp appartiene al pacchetto più ampio per workflow e non serve al provisioning dei server.

Quale modalità scegliere?

Scegli esplicitamente singola o coda prima della distribuzione. La coda richiede Postgres e Redis, non SQLite.

Posso perdere le credenziali salvate?

Sì, se la chiave di cifratura viene persa o cambiata. Conserva una copia protetta fuori dal server insieme ai backup dei dati.

Una risposta HTTP di integrità è sufficiente?

No. La skill verifica anche TLS pubblico, disponibilità e, se applicabile, parità dei worker ed esecutori di attività.

Altre skill IA

Skill correlate

Categorie di skill