The Ultimate Guide to Deploying n8n

Welcome to the comprehensive, step-by-step guide on how to deploy n8n.io in any environment—from your local computer to Enterprise-grade Kubernetes clusters.

Inspired by the structured approach of "Python for Developers," this repository provides a logical progression from basic setups to high-availability architectures.

---

📚 Table of Contents

Part I: Basic Local Deployments

• Chapter 01 - Local Installation via Node.js (Windows, Mac, Linux)
• Chapter 02 - n8n in Local Docker Compose with Persistent Data
• Chapter 03 - Running n8n as a Service Using PM2
• Chapter 04 - Deploying n8n on a Raspberry Pi

Part II: VPS and Cloud VM Deployments

• Chapter 05 - Ubuntu VPS Deployment (Node.js)
• Chapter 06 - Ubuntu VPS Deployment (Docker)
• Chapter 07 - Reverse Proxy with Nginx and SSL (HTTPS)
• Chapter 08 - Deploying on AWS EC2 Instance
• Chapter 09 - Deploying on DigitalOcean Droplet
• Chapter 10 - Deploying on Google Cloud VM Instance
• Chapter 11 - Deploying on Azure VM Instance
• Chapter 12 - Exposing Private n8n via Tunnels (Cloudflare, Tailscale)
• Chapter 13 - Deploying on Render or Heroku PaaS
• Chapter 14 - Deploying with CapRover or Dokku

Part III: Advanced Container & Kubernetes Deployments

• Chapter 15 - Docker Compose with External PostgreSQL
• Chapter 16 - Scaling with Queue Mode (Postgres and Redis)
• Chapter 17 - Docker Swarm Cluster Deployment
• Chapter 18 - Kubernetes Deployment (Single Pod)
• Chapter 19 - Kubernetes with Managed External Database
• Chapter 20 - Kubernetes Ingress and Let’s Encrypt
• Chapter 21 - Scaled Kubernetes Architecture (Queue Mode)
• Chapter 22 - Deploying n8n via Helm Chart
• Chapter 23 - AWS ECS Fargate Serverless Deployment
• Chapter 24 - Google Cloud Run Serverless Deployment
• Chapter 25 - Azure Container Instances Deployment
• Chapter 26 - HashiCorp Nomad Deployment

Part IV: Enterprise and Creative Architectures

• Chapter 27 - High Availability Setup (Horizontal Scaling)
• Chapter 28 - Multi-Region Deployment & Disaster Recovery
• Chapter 29 - Backup, Restore, and Data Persistence Strategies
• Chapter 30 - CI/CD and GitOps for n8n Deployments
• Chapter 31 - Centralized Logging and Monitoring (ELK, Grafana)
• Chapter 32 - Security Hardening and Best Practices
• Chapter 33 - Workflow Version Control and Team Collaboration

---

Prerequisites

Before beginning, ensure you have basic knowledge of:

• Command Line (Terminal)
• Basic Networking (DNS, Ports)
• Docker (for Chapters 2 and beyond)

About this Guide

This repository is a live documentation project. Each chapter contains a Jupyter Notebook with:

1. Overview: What we are deploying.
2. Commands: Ready-to-copy terminal commands.
3. Configurations: YAML/Config files needed for the environment.
4. Troubleshooting: Common issues for that specific setup.