N8N Deployment Guide: Self-Host Workflow Automation on a VPS with Docker

Sat, 16 May 2026 10:00:00 +0800

Why N8N?

N8N is an open-source workflow automation tool, similar to Zapier and Make, but you deploy it on your own server for full data control and privacy.

N8N Advantages

🔓 Open Source & Free: Community edition is completely free with no user limits
🔒 Self-Hosted Data: Sensitive data never leaves your server
🔌 400+ Integrations: Slack, GitHub, Gmail, Discord, and more
🧩 Visual Builder: Drag-and-drop editor, no coding required
🏢 Extensible: Custom nodes and scripts supported

Prerequisites

A VPS (2GB RAM recommended)
Docker and Docker Compose installed
A domain name (optional, for HTTPS)
Basic Linux command line knowledge

Step 1: Install Docker

# Install Docker
curl -fsSL https://get.docker.com | sh

# Enable Docker on boot
sudo systemctl enable docker
sudo systemctl start docker

# Install Docker Compose plugin
sudo apt-get install docker-compose-plugin -y

Step 2: Create Docker Compose Configuration

mkdir -p ~/n8n && cd ~/n8n

Create docker-compose.yml:

version: '3.8'

services:
 n8n:
 image: n8nio/n8n:latest
 container_name: n8n
 restart: unless-stopped
 ports:
 - "5678:5678"
 environment:
 - N8N_HOST=${N8N_HOST}
 - N8N_PORT=5678
 - N8N_PROTOCOL=https
 - WEBHOOK_URL=https://${N8N_HOST}/
 - DB_TYPE=postgresdb
 - DB_POSTGRESDB_HOST=postgres
 - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
 - DB_POSTGRESDB_USER=${POSTGRES_USER}
 - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
 - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
 volumes:
 - n8n_data:/home/node/.n8n
 depends_on:
 postgres:
 condition: service_healthy
 networks:
 - n8n_network

 postgres:
 image: postgres:15-alpine
 container_name: n8n-postgres
 restart: unless-stopped
 environment:
 - POSTGRES_USER=${POSTGRES_USER}
 - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
 - POSTGRES_DB=${POSTGRES_DB}
 volumes:
 - postgres_data:/var/lib/postgresql/data
 healthcheck:
 test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
 interval: 10s
 timeout: 5s
 retries: 5
 networks:
 - n8n_network

volumes:
 n8n_data:
 postgres_data:

networks:
 n8n_network:
 driver: bridge

Step 3: Configure Environment Variables

Create .env file:

cat > .env << 'EOF'
N8N_HOST=n8n.yourdomain.com
N8N_ENCRYPTION_KEY=$(openssl rand -hex 32)
POSTGRES_USER=n8n
POSTGRES_PASSWORD=$(openssl rand -base64 32)
POSTGRES_DB=n8n
EOF

⚠️ Security Note: Always replace N8N_ENCRYPTION_KEY and POSTGRES_PASSWORD with strong, unique values.

Step 4: Configure Nginx Reverse Proxy

server {
 listen 80;
 server_name n8n.yourdomain.com;
 return 301 https://$server_name$request_uri;
}

server {
 listen 443 ssl http2;
 server_name n8n.yourdomain.com;

 ssl_certificate /etc/letsencrypt/live/n8n.yourdomain.com/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/live/n8n.yourdomain.com/privkey.pem;

 location / {
 proxy_pass http://localhost:5678;
 proxy_http_version 1.1;
 proxy_set_header Upgrade $http_upgrade;
 proxy_set_header Connection "upgrade";
 proxy_set_header Host $host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-Proto $scheme;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 }
}

Step 5: Get SSL Certificate

# Install acme.sh
curl https://get.acme.sh | sh

# Issue certificate
acme.sh --issue -d n8n.yourdomain.com --nginx

# Install certificate
acme.sh --install-cert -d n8n.yourdomain.com \
 --key-file /etc/nginx/ssl/n8n.key \
 --fullchain-file /etc/nginx/ssl/n8n.crt

Step 6: Launch N8N

cd ~/n8n
docker compose up -d

Check the logs:

docker compose logs -f n8n

Visit https://n8n.yourdomain.com to complete the initial setup.

Management Commands

# View logs
docker compose logs -f n8n

# Restart service
docker compose restart n8n

# Update N8N
docker compose pull n8n
docker compose up -d n8n

# Backup database
docker exec n8n-postgres pg_dump -U n8n n8n > backup_$(date +%Y%m%d).sql

Summary

With Docker Compose, you can deploy n8n in under 10 minutes. Combined with PostgreSQL, Nginx, and Let’s Encrypt, you’ll have a production-grade workflow automation platform running on your own VPS.

Next, explore n8n’s 400+ integration nodes and start building your own automated workflows!

Deployment Guides on SelfVPS Guide