n8n Self-Hosting Deployment
Deploy production self-hosted n8n on Linux with Docker Compose, Caddy, and automatic HTTPS.
The evidence requires fresh secrets on the target host, mode-600 .env handling, no committed secrets, private internal ports, DNS/port preflight, backup guidance, and immediate owner setup, which reduces obvious risk. Eleven points are deducted because it does not require explicit final-user confirmation before SSH, Docker installation, firewall changes, or service launch; deployment performs high-impact remote actions; rollback is only partially safe; init-data.sh interpolates environment values directly into SQL without robust escaping or validation; and attribution consists of links to official documentation without fixed, independently verifiable source evidence.
The evidence provides ordered procedures, mode branching, health checks, TLS retries, and several useful failure explanations. Four points are deducted because this static review cannot reproduce execution; the Caddyfile, env examples, and some referenced materials are absent from the supplied evidence; Docker installation, permissions, firewall, DNS propagation, and startup failures lack sufficiently complete diagnostic branches; and several command/version assumptions are not verified within the assessed path. The score therefore remains below the static ceiling of 10.
The evidence clearly identifies the audience, Linux/SSH/Docker environment, single versus queue modes, trigger semantics, non-fit cases, and required inputs such as domain, email, and timezone. Six points are deducted for limited boundaries around non-Debian hosts, existing services, non-Docker deployments, insufficient privileges, complex networks, and existing n8n instances; core operation depends on Docker images, Let's Encrypt, DNS, and overseas documentation/network services without mainland-China reachability or fallback guidance; and Chinese-language interaction support is not specified.
The evidence includes an orchestrating SKILL.md, mode-specific references, an assets directory, README structure, an MIT license, README version 1.1.0, and official documentation links, giving it a readable information architecture. Seven points are deducted because the selected skill does not clearly identify maintenance ownership, release/update workflow, or a changelog; versioning is only stated in the repository README; several referenced templates and references are absent from the supplied material; installation, FAQ, troubleshooting, and compatibility details still rely on unseen content; and publisher identity is unverified.
The evidence covers the intended lifecycle from preflight through deployment, TLS verification, updates, backup, restore, and hardening, with concrete Compose templates and commands. Ten points are deducted because static reading cannot establish that the commands and templates work with the claimed versions; key assets such as the Caddyfile and env examples are missing, preventing confirmation of a directly usable end-to-end result; queue sizing and recovery complexity, external dependencies, and migration risks still require manual review. The score is therefore limited and remains below the static ceiling of 7.
The evidence links to multiple official n8n documentation paths and supplies health, log, and version checks that provide audit points. Six points are deducted because there are no execution results, CI workflows, committed test suites, or third-party reproduction records; key assets are missing, so cross-checking is incomplete; README claims about testing and production-tested patterns do not establish reproducible evidence for this skill path; and the score remains below the static ceiling of 5.
- Obtain explicit user confirmation before remote SSH actions, Docker installation, firewall changes, public DNS/TLS exposure, and service startup, and verify the host and data directory.
- The supplied evidence omits the Caddyfile and env examples referenced by SKILL.md, so end-to-end reproducibility cannot be confirmed from this static review.
- Queue-mode recovery depends on both database backups and the original N8N_ENCRYPTION_KEY; post-upgrade migrations may make downgrade infeasible.
- The deployment depends on Docker images, DNS, Let's Encrypt, and external documentation services; mainland-China reachability and fallbacks are unspecified.
- Do not use init-data.sh with untrusted database identifiers or passwords without reviewing SQL escaping and injection exposure.
What does this skill do, and when should you use it?
This skill is for users who want to run n8n on their own VPS or Linux server. Over SSH, it turns a fresh Ubuntu/Debian-like VM into a production HTTPS deployment using Docker Compose and Caddy, with either single-instance or queue mode. It covers preflight checks, Docker installation, template transfer, secret generation, launch, TLS verification, and day-two operations such as updates, backups, restores, and hardening. It does not target n8n Cloud or workflow construction.
Connects over SSH to check the operating system, DNS, public IP, ports 80/443, and firewall access; installs Docker Engine and the Compose plugin when needed; transfers Compose, Caddy, environment-example, and queue initialization files; generates the n8n encryption key and queue-mode database secrets on the target server; configures either SQLite single mode or queue mode with Redis, Postgres, the main process, and workers; starts the stack and verifies container health, n8n healthz, Caddy certificate issuance, and public HTTPS reachability; hands off the URL, encryption-key backup guidance, and update, backup, restore, and hardening basics.
- An individual or small team wants a lightweight n8n deployment on Hetzner, DigitalOcean, AWS EC2, or bare metal and chooses single mode with SQLite.
- A team expects high execution volume, long-running jobs, or horizontal scaling and needs queue mode with Redis, Postgres, and multiple workers.
- An operator needs to put self-hosted n8n behind a domain, Caddy reverse proxy, and automatic Let's Encrypt HTTPS.
- An administrator needs a documented path for updating, backing up, restoring, or hardening an existing self-hosted n8n instance.
What are this skill's strengths and limitations?
- Covers the full path from a fresh Linux VM to an HTTPS n8n instance.
- Supports both single-mode SQLite and queue mode with Redis, Postgres, and workers.
- Requires fresh secrets to be generated on the target and keeps n8n, Postgres, and Redis off public host ports.
- Includes DNS, cloud-firewall, TLS, health-check, update, backup, restore, and hardening guidance.
- Requires root or sudo SSH access, control of a domain, and publicly reachable ports 80 and 443.
- Targets fresh Ubuntu/Debian-like Linux VMs; the source gives no support details for Windows, macOS, or other distributions.
- Queue mode has higher resource needs, with a rough floor of about 4 GB RAM and approximately 1–2 GB per worker.
- It explicitly excludes n8n Cloud and workflow building, and the source does not document a standalone installation path outside the Claude Code collection.
How do you install this skill?
The skill is installed as part of the czlonkowski/n8n-skills repository; the source does not provide a separate standalone installation command. For Claude Code, the recommended command is /plugin install czlonkowski/n8n-skills. Manual installation is git clone https://github.com/czlonkowski/n8n-skills.git, followed by cp -r n8n-skills/skills/* ~/.claude/skills/, then reload Claude Code. The repository also lists an n8n-mcp MCP server as a prerequisite for the collection, although this deployment SKILL.md does not state that it calls MCP.
How do you use this skill?
With the skill loaded, ask for a concrete operation such as Deploy n8n on my server with Docker Compose, Set up self-hosted n8n in queue mode, or Back up and harden my n8n instance. The assistant first asks whether to use single/regular or queue mode, then collects the SSH target, domain, Let's Encrypt email, and timezone before performing preflight, deployment, launch, and HTTPS verification.
How does this skill compare with similar options?
Compared with n8n Cloud, this targets Docker-based n8n managed on the user's own server. Compared with the repository's workflow-building skills, it focuses on deployment, operations, and security rather than creating workflows.