--- title: "How to Self-Host n8n: Complete Guide to Workflow Automation" description: "Guide to self-hosting n8n, an open-source workflow automation platform. Includes Docker, Traefik, and Dokploy setup options." date: 2025-08-02 categories: ["VPS"] tags: ["self-hosted","docker"] --- Managing workflows across multiple applications gets complicated fast. Whether you're automating document processing, syncing data between platforms, or building multi-step business processes, an automation tool helps. **n8n** is an open-source, self-hosted workflow automation platform. It competes with tools like Zapier or Microsoft Power Automate, but you host it yourself and customize it however you want. ## What is n8n? n8n (pronounced "nodemation") connects different services and automates repetitive tasks through a visual interface. The platform uses nodes—components that perform specific functions—connected together to form automation sequences. ### Key Benefits of n8n - **Visual Workflow Builder**: Create automations using a drag-and-drop interface - **400+ Built-in Integrations**: Connect to Google Workspace, Microsoft 365, Slack, GitHub, databases, and APIs - **Custom JavaScript Nodes**: Write custom code when pre-built nodes don't do what you need - **Webhook Support**: Trigger workflows from external events - **Advanced Flow Control**: Add conditional logic, loops, error handling, and parallel processing - **Queue Mode**: Process high-volume operations with queuing and retry mechanisms - **Credential Management**: Securely store and manage API keys, tokens, and authentication details with encryption - **Version Control Integration**: Track workflow changes with Git - **Self-Hosted Privacy**: Keep your data on your own servers - **Extensive API**: Manage workflows and configurations through REST APIs - **Multi-Environment Support**: Deploy across development, staging, and production environments - **Active Community**: Get regular updates and community-contributed nodes The project maintains an open-source approach with additional enterprise features available for organizations requiring advanced capabilities. You can explore the codebase and contribute at the [official GitHub repository](https://github.com/n8n-io/n8n) or visit their [website](https://n8n.io) for comprehensive documentation. ### How n8n Works n8n uses nodes. Each node represents a function or service integration. You create workflows by connecting nodes in sequence, and data flows from one node to the next. | Component Type | Purpose | Use Cases | |---------------|---------|-----------| | **Trigger Nodes** | Initiate workflow execution | Webhook requests, scheduled tasks, file changes, email arrivals | | **Regular Nodes** | Perform actions | API calls, data processing, file operations | | **Control Nodes** | Manage workflow logic | Conditional branching, loops, error handling, data merging | | **Code Nodes** | Run custom scripts | Complex calculations, data transformations | | **Sub-workflow Nodes** | Reference other workflows | Reusable components, modular design | This modular approach lets you build simple data sync tasks or complex multi-step business processes. n8n is lightweight, but complex workflows with multiple executions need adequate resources. **Essential Requirements:** - **Server Infrastructure**: A VPS or dedicated server. [Hetzner](https://go.bitdoze.com/hetzner), [Hostinger](https://go.bitdoze.com/hostinger-vps) works well, or use a [Mini PC as Home Server](https://www.bitdoze.com/best-mini-pc-home-server/) - **Operating System**: Linux-based system (Ubuntu 20.04+ recommended) with Docker support - **Domain Name**: A registered domain for accessing your n8n instance (e.g., n8n.yourdomain.com) - **SSL Certificate**: For secure HTTPS access to your workflows and webhook endpoints **Technical Prerequisites:** - **Reverse Proxy Setup**: Traefik configured with Docker: - [How to Use Traefik as A Reverse Proxy in Docker](https://www.bitdoze.com/traefik-proxy-docker/) - [Traefik FREE Let's Encrypt Wildcard Certificate With CloudFlare Provider](https://www.bitdoze.com/traefik-wildcard-certificate/) - **Container Management**: Docker and Docker Compose installed on your server - **Optional Management UI**: Dockge for simplified container management - see [Dockge - Portainer Alternative for Docker Management](https://www.bitdoze.com/dockge-install/) **Recommended Specifications:** | Component | Minimum | Recommended | Enterprise | |-----------|---------|-------------|------------| | **CPU** | 2 cores | 4 cores | 8+ cores | | **RAM** | 2GB | 4GB | 8GB+ | | **Storage** | 20GB SSD | 50GB SSD | 100GB+ NVMe | | **Network** | 100 Mbps | 1 Gbps | 10 Gbps | Complex workflows with frequent API calls or large data processing may need higher specs. Monitor usage and scale as needed. ## Setup Option 1: Docker & Docker Compose (Standalone) This approach works well for getting started or development environments where you want direct access to n8n. ### Step 1: Create Project Directory Create a directory for your n8n installation: ```bash mkdir -p ~/n8n-automation && cd ~/n8n-automation ``` This creates a clean workspace where all n8n-related files will be organized and easily manageable. ### Step 2: Create Docker Compose Configuration Create a comprehensive Docker Compose file that includes both n8n and Redis for optimal performance: ```yaml version: '3.8' services: n8n: image: docker.n8n.io/n8nio/n8n:latest container_name: n8n-app restart: unless-stopped ports: - '5678:5678' environment: - VUE_APP_URL_BASE_API=http://localhost:5678 - N8N_EDITOR_BASE_URL=http://localhost:5678 - WEBHOOK_URL=http://localhost:5678 - GENERIC_TIMEZONE=UTC - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY} - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true - DB_TYPE=sqlite - N8N_LOG_LEVEL=info - N8N_LOG_OUTPUT=console - EXECUTIONS_DATA_PRUNE=true - EXECUTIONS_DATA_MAX_AGE=168 volumes: - ./data:/home/node/.n8n - ./files:/files - ./custom-nodes:/opt/custom-nodes cap_drop: - ALL cap_add: - SETUID - SETGID - CHOWN - DAC_OVERRIDE depends_on: redis: condition: service_healthy healthcheck: test: ['CMD', 'wget', '--no-verbose', '--tries=1', '--spider', 'http://localhost:5678/healthz'] interval: 30s timeout: 10s retries: 3 start_period: 40s redis: container_name: n8n-redis image: redis:7-alpine command: redis-server --appendonly yes --maxmemory 512mb --maxmemory-policy allkeys-lru restart: unless-stopped volumes: - redis-data:/data cap_drop: - ALL cap_add: - SETUID - SETGID - CHOWN - DAC_OVERRIDE healthcheck: test: ['CMD', 'redis-cli', 'ping'] interval: 15s timeout: 5s retries: 3 start_period: 30s volumes: redis-data: driver: local ``` ### Step 3: Initialize Configuration Directory Set up the necessary directories and generate a secure encryption key: ```bash # Create required directories mkdir -p {data,files,custom-nodes} # Generate a secure encryption key echo "N8N_ENCRYPTION_KEY=$(openssl rand -base64 32)" > .env # Set proper permissions chmod 700 data chmod 755 files custom-nodes ``` The encryption key is crucial for securing credentials and sensitive data. Store it safely and use the same key when migrating or backing up your n8n instance. ### Step 4: Launch n8n Start your n8n instance and verify the deployment: ```bash # Launch the containers docker compose up -d # Verify containers are running docker compose ps # Check logs for any issues docker compose logs -f n8n ``` ### Step 5: Access Your Automation Platform Navigate to `http://localhost:5678` in your web browser. You'll be greeted with the n8n setup wizard where you can: - Create your administrator account - Configure basic settings - Start building your first workflow Your n8n instance is now operational! You can begin creating powerful automation workflows immediately. ## Setup Option 2: Traefik & Dockge Integration This professional setup provides automatic HTTPS certificates, domain routing, and simplified management through Dockge's intuitive interface—ideal for production environments. Ensure you have Traefik configured with wildcard certificates using our [comprehensive guide](https://www.bitdoze.com/traefik-wildcard-certificate/). This setup assumes you're using CloudFlare as your DNS provider. ### Step 1: Prepare Traefik Network Establish the external network that Traefik uses for service discovery: ```bash # Create the Traefik network if it doesn't exist docker network create traefik-net 2>/dev/null || echo "Network already exists" # Verify network creation docker network ls | grep traefik-net ``` ### Step 2: Enhanced Docker Compose with Traefik Labels Create a production-ready configuration with automatic SSL and domain routing: ```yaml version: '3.8' networks: traefik-net: external: true services: n8n: image: docker.n8n.io/n8nio/n8n:latest container_name: n8n-production environment: - VUE_APP_URL_BASE_API=https://n8n.yourdomain.com - N8N_EDITOR_BASE_URL=https://n8n.yourdomain.com - WEBHOOK_URL=https://n8n.yourdomain.com - GENERIC_TIMEZONE=UTC - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY} - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true - DB_TYPE=sqlite - N8N_LOG_LEVEL=warn - N8N_LOG_OUTPUT=file - EXECUTIONS_DATA_PRUNE=true - EXECUTIONS_DATA_MAX_AGE=336 - N8N_METRICS=true - QUEUE_BULL_REDIS_HOST=redis - QUEUE_BULL_REDIS_PORT=6379 volumes: - ./data:/home/node/.n8n - ./files:/files - ./logs:/var/log/n8n networks: - traefik-net depends_on: redis: condition: service_healthy restart: unless-stopped labels: - "traefik.enable=true" - "traefik.http.routers.n8n.rule=Host(`n8n.yourdomain.com`)" - "traefik.http.routers.n8n.entrypoints=https" - "traefik.http.routers.n8n.tls=true" - "traefik.http.routers.n8n.tls.certresolver=letsencrypt" - "traefik.http.services.n8n.loadbalancer.server.port=5678" - "traefik.http.routers.n8n.middlewares=security-headers@file" redis: container_name: n8n-redis-prod image: redis:7-alpine command: redis-server --appendonly yes --maxmemory 1gb --maxmemory-policy allkeys-lru --save 900 1 restart: unless-stopped networks: - traefik-net volumes: - redis-data:/data - ./redis-config:/usr/local/etc/redis cap_drop: - ALL cap_add: - SETUID - SETGID - CHOWN - DAC_OVERRIDE healthcheck: test: ['CMD', 'redis-cli', 'ping'] interval: 30s timeout: 5s retries: 5 start_period: 30s volumes: redis-data: driver: local ``` ### Step 3: Deploy Through Dockge If you're using Dockge for container management: 1. **Access Dockge Interface**: Navigate to your Dockge installation 2. **Create New Stack**: Click "Create Stack" and name it "n8n-production" 3. **Paste Configuration**: Copy the Docker Compose content above 4. **Configure Environment**: Add your encryption key and domain settings 5. **Deploy Stack**: Click deploy and monitor the deployment logs