n8n One-Click Docker Setup

A minimal, production-ready Docker Compose setup to deploy n8n in minutes.

This repository focuses on:

• Simple one-command startup
• Persistent data storage
• Clean environment-based configuration
• Webhook-ready for production use

---

Features

• 🚀 One-click deployment with Docker Compose
• 💾 Persistent n8n data (no data loss on restart)
• 🔧 Configuration via .env file
• 🌐 Webhook-ready (works with reverse proxy, SSL, Cloudflare)
• 🧩 Easy to extend (Nginx, SSL, database, etc.)

---

Requirements

• Docker
• Docker Compose (v2+)

---

Quick Start

# Clone repository
git clone https://github.com/your-username/n8n-one-click.git
cd n8n-one-click

# Prepare environment
cp .env.example .env

# Start n8n
docker compose up -d

Access n8n at:

http://YOUR_SERVER_IP:5678

---

Environment Variables

Edit the .env file to match your setup:

N8N_HOST=n8n.example.com
N8N_PROTOCOL=https
N8N_PORT=5678
WEBHOOK_URL=https://n8n.example.com/
TZ=Asia/Ho_Chi_Minh

Notes

• WEBHOOK_URL is required for webhook triggers
• Use a public domain for production
• HTTPS is strongly recommended

---

Data Persistence

All n8n data is stored in:

./n8n_data/

Backup this directory regularly to protect your workflows and credentials.

---

Production Tips

• Do not use the latest tag in production
• Run n8n behind a reverse proxy (Nginx / Traefik)
• Enable HTTPS before using webhooks
• Keep .env out of version control

---

Upgrade

docker compose pull
docker compose up -d

---

License

MIT License

---

Why this repo?

This setup is designed for developers who want a clean, predictable, and maintainable way to run n8n — without unnecessary complexity.

Clone, configure, and run. That's it.