Tooluck logoTooluck
SKILL.md

n8n-self-hosting

Agent skill fromczlonkowski/n8n-skills

Deploy a production self-hosted n8n end-to-end to a fresh Linux VM over SSH, using Docker Compose behind a Caddy reverse proxy with automatic HTTPS. Use whenever the user wants to self-host, install, provision, or deploy n8n on their own server/VPS (Hetzner, DigitalOcean, AWS EC2, bare metal) — single/regular mode or queue mode with workers — or to update, back up, restore, or harden such an instance, or make Python Code nodes run on it (task runners). For SELF-HOSTED n8n (Docker), not n8n Cloud and not building workflows. The skill makes the agent ask single-vs-queue first, collect domain/SSH/timezone inputs, generate fresh secrets on the box, and bring the stack up with TLS. Trigger on "deploy n8n", "self-host n8n", "n8n docker compose", "n8n queue mode / workers", "n8n reverse proxy / SSL", "back up / update my n8n", "Python runner unavailable" / "n8nio/runners sidecar", or "we don't want to give every user the OAuth client secret" / "enable Sign in with Google" (credential overwrit

How to install n8n-self-hosting

install n8n-self-hosting
# install the n8n-skills pack with the skills CLI
npx skills add czlonkowski/n8n-skills

# or add only this skill to Claude Code: copy the folder

skills/n8n-self-hosting/

# into

~/.claude/skills/n8n-self-hosting/ (all projects)

.claude/skills/n8n-self-hosting/ (one project)

skills/n8n-self-hosting/SKILL.md

MITFull file
1# Deploying self-hosted n8n
2
3This skill takes a **fresh Linux VM** (Ubuntu/Debian, root or sudo SSH) to a **running,
4HTTPS, production n8n** via Docker Compose behind **Caddy** (automatic Let's Encrypt TLS).
5It is for **self-hosted n8n on Docker** — not n8n Cloud, and not for building workflows
6(that's the rest of this pack).
7
8Two deployment modes. The architectures differ, so **pick the mode before doing anything**.
9
10You drive this end-to-end over SSH: preflight → install Docker → lay down the project →
11generate secrets → launch → verify TLS → hand off. The template files live in `assets/`;
12the per-mode and security depth live in the reference files named below.
13
14## Rule 0 — choose the mode (ask the user)
15
16Do not guess. Ask, then commit to one:
17
18| | **Single / regular** | **Queue** |
19|---|---|---|
20| Processes | one n8n | main + N workers |
21| Extra services | none (SQLite) | Redis (queue) + Postgres (DB) |
22| Executes workflows | in the main process | on workers, in parallel |
23| Good for | 1 user, light/moderate load, simplest ops | high volume, heavy/long executions, horizontal scale |
24| Compose | `assets/docker-compose.single.yml` | `assets/docker-compose.queue.yml` |
25| Deep dive | **`SINGLE_MODE.md`** | **`QUEUE_MODE.md`** |
26
27If unsure, start **single** — it's the simplest correct thing and covers most needs. Moving
28to queue later means swapping the compose file and migrating SQLite→Postgres, so if the user
29already expects real volume, start **queue**.
30…

Excerpt shown under the repository's MIT license.

More skills in n8n-skills

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates