How to Install n8n With Docker: Self-Host Guide

Why Professionals Prefer Docker for n8n

When you want to install n8n with Docker, you are choosing stability and isolation. At Testified.AI, we run hundreds of automation tests monthly, and relying on global Node.js packages often leads to version conflicts. Using containers ensures that your automation environment remains perfectly consistent across different servers. This consistency is exactly why we strongly recommend self hosting n8n with Docker for any serious automation project.

You avoid the unexpected downtime that can happen with shared cloud environments. Furthermore, a proper n8n install with Docker allows you to roll back to previous versions instantly if a new update breaks your critical workflows. It is the gold standard for production environments.

Self-hosting your automation layer requires isolation. Docker provides the exact boundary needed to prevent custom Python or Node scripts inside your workflows from crashing your core server operations.

Comparing Deployment Methods

Before you commit to a specific path, it helps to understand the landscape of deployment options. Here is a brief comparison of why containers win out in our independent testing.

Prerequisites for Your Setup

Before you learn how to run n8n with Docker, you need a suitable host environment. You can use a Virtual Private Server from providers like DigitalOcean or Hetzner, or you can install n8n locally with Docker on your own machine. Your system should have at least 1GB of RAM, though 2GB is heavily recommended for handling concurrent webhooks.

You must have both Docker and Docker Compose installed on your system. If you are using Windows or Mac, Docker Desktop handles this automatically. For Linux servers, you will need to install the engine and the compose plugin via your package manager. Once installed, verify the service is running by checking the version in your terminal.

Step-by-Step Installation Process

Step 1: Create Your Directory Structure

Organization is critical when you self host n8n with Docker. Create a dedicated folder on your server specifically for this application. Inside this folder, you will store your configuration files and the persistent data volumes. This makes future backups incredibly simple.

Open your terminal and create a folder named n8n-docker. Navigate into it and create a file named docker-compose.yml. Also, create a hidden file named .env to store your sensitive environment variables securely.

Step 2: Configure the Compose File

The compose file is the blueprint for your deployment. If you want to run n8n with Docker correctly, you need to define the image, ports, and volumes accurately. We recommend using the official n8nio/n8n image to ensure you receive the latest stable releases directly from the developers.

Map port 5678 on your host machine to port 5678 in the container. More importantly, map a local directory to /home/node/.n8n inside the container. This volume mapping ensures that your workflows, credentials, and execution history survive container restarts.

version: '3.8'

# Define the persistent volume for our data
volumes:
  n8n_data:
    name: n8n_data

services:
  n8n:
    # Use the official, most up-to-date n8n image
    image: docker.n8n.io/n8nio/n8n:latest
    container_name: n8n_server
    
    # Ensures the container restarts automatically if the server reboots
    restart: unless-stopped
    
    # Map the host port to the container port
    ports:
      - "5678:5678"
      
    environment:
      # Set your timezone (Adjust to your local timezone)
      - GENERIC_TIMEZONE=Europe/Budapest
      - TZ=Europe/Budapest
      
      # Webhook URL setup (Uncomment and change to your domain for production)
      # - WEBHOOK_URL=https://n8n.yourdomain.com/
      
      # Optional: Enable basic authentication for extra security
      # - N8N_BASIC_AUTH_ACTIVE=true
      # - N8N_BASIC_AUTH_USER=admin
      # - N8N_BASIC_AUTH_PASSWORD=your_secure_password
      
    volumes:
      # Map the volume to ensure workflows and credentials survive restarts
      - n8n_data:/home/node/.n8n

Step 3: Execute and Verify

Now that your blueprint is ready, it is time to execute. Run the command docker compose up -d in your terminal. The system will download the necessary layers and start the service in the background. This is the core of how to use n8n with Docker effectively.

Open your web browser and navigate to localhost:5678 or your server IP address on that same port. You should see the initial setup screen asking you to create an administrator account. Your local instance is now fully operational and ready for workflow creation.

Security and External Access

If you are self-hosting n8n with Docker on a local machine but need to receive webhooks from external services like Stripe or GitHub, you must expose your instance safely. We strictly advise against opening ports directly to the internet without a reverse proxy. Tools like Ngrok or Cloudflare Tunnels are excellent for secure, temporary exposure during testing.

For permanent production servers, place your container behind Traefik or Nginx Proxy Manager. These tools automate SSL certificate generation via Let's Encrypt and provide an essential layer of security. Always enforce strong passwords and enable basic authentication if your workflows contain highly sensitive internal company data.