Automation & Ops n8ndocker-composeself-hostingcaddyreverse-proxyautomatic-httpsqueue-modelinux-server

n8n Self-Hosting Deployment

Deploy production self-hosted n8n on Linux with Docker Compose, Caddy, and automatic HTTPS.

FollowSkills review · FSRS-2.0
Not recommended
46/ 100 5-point scale 2.3 / 5
Trust14 / 25 · 2.8/5

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.

Reliability6 / 20 · 1.5/5

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.

Adaptability9 / 15 · 3.0/5

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.

Convention8 / 15 · 2.7/5

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.

Effectiveness5 / 15 · 1.7/5

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.

Verifiability4 / 10 · 2.0/5

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.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 05eea4848c12
Before you use it
  • 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.
See the full review method →

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.

  1. An individual or small team wants a lightweight n8n deployment on Hetzner, DigitalOcean, AWS EC2, or bare metal and chooses single mode with SQLite.
  2. A team expects high execution volume, long-running jobs, or horizontal scaling and needs queue mode with Redis, Postgres, and multiple workers.
  3. An operator needs to put self-hosted n8n behind a domain, Caddy reverse proxy, and automatic Let's Encrypt HTTPS.
  4. 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?

Pros
  • 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.
Limitations
  • 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.

FAQ

Is this for n8n Cloud?
No. It explicitly targets self-hosted n8n on Docker, not n8n Cloud.
What must be ready before deployment?
You need root or sudo SSH access, a domain already pointing to the server, a Let's Encrypt email, a timezone, and internet-reachable ports 80 and 443.
How do I choose between single and queue mode?
Single mode is intended for one user and light or moderate load. Queue mode is intended for high volume, heavy or long executions, or horizontal scaling, and uses Redis, Postgres, and workers.
What happens if the encryption key is lost?
Stored credentials become undecryptable, so the key must be backed up securely off the server.

More skills from this repository

All from czlonkowski/n8n-skills

Dev & Engineering

n8n AI Code Tool Guide

Write JavaScript or Python that obeys the n8n Custom Code Tool contract for AI-agent calls.

Automation & Ops

n8n Binary & File Handling

Keep files intact in n8n workflows and move them safely through AI tools and chat interfaces.

Automation & Ops

n8n Error Handling

Make n8n workflow failures routable, visible, and recoverable.

Automation & Ops

n8n Multi-Instance Targeting

Safely select, verify, and switch the n8n instance targeted by an MCP session.

Automation & Ops

n8n AI Agent Architecture Guide

Design n8n AI agents with the right nodes, tool connections, memory, structured output, and human approval.

Automation & Ops

n8n MCP Workflow Router

Routes n8n-mcp tasks to the right skills and reduces production workflow failures.

Dev & Engineering

n8n Python Code Node Guide

Write dependable Python for n8n Code nodes within their real runtime limits.

Automation & Ops

n8n Subworkflow Architect

Turn reusable n8n logic into explicit, testable sub-workflows that humans and AI agents can discover and call safely.

Dev & Engineering

n8n JavaScript Code Node Guide

Write reliable, efficient JavaScript for n8n Code nodes.

Dev & Engineering

n8n Expression Syntax Guide

Write, validate, and repair n8n expressions for reliable workflow data mapping.

Automation & Ops

n8n Node Configuration Guide

Configure n8n nodes by operation and dependency to reduce validation errors and silent runtime failures.

Automation & Ops

n8n Validation Expert

Explains n8n validation results and guides iterative fixes for problems that can stop workflows from running.

Automation & Ops

n8n MCP Tools Expert

A practical guide for reliably searching, validating, and managing n8n workflows.

Automation & Ops

n8n Workflow Architecture Patterns

Design, validate, and deploy reliable n8n workflows with proven architectural patterns.

Related skills