When it comes to self-hosting n8n, using Docker is widely considered the gold standard for production-grade environments. It offers an isolated, secure, and highly portable way to run your automation engine without cluttering your local operating system.
In this guide, based on the tutorial from GenAI Unplugged, we’ll show you how to set up n8n as a Docker container on your Mac or Windows machine using Docker Desktop.
Why Choose Docker for n8n?
While the NPM installation is great for quick tests, Docker provides several “pro” advantages:
- Isolation: The n8n instance runs in its own “container,” meaning it won’t conflict with other software on your computer [01:56].
- Database Control: While n8n uses SQLite by default, Docker makes it much easier to switch to a more robust database like PostgreSQL for heavy workloads [01:36].
- Easy Migration: Because the entire environment is “containerized,” you can easily move your n8n setup from your laptop to a cloud server (like DigitalOcean or AWS) without configuration headaches [02:01].
Step 1: Install Docker Desktop
Before you can run n8n, you need the engine that powers it.
- Download: Visit the official Docker website and download Docker Desktop for Mac (Intel or Apple Silicon) or Windows [03:56].
- Install: Drag the application to your folder and follow the on-screen prompts. Note that for large enterprises, Docker Desktop may require a paid subscription, but it remains free for personal use and small businesses [03:32].
- Launch: Open Docker Desktop and ensure the engine is running in the background [05:04].
Step 2: Create a Data Volume
You don’t want to lose your workflows every time you restart the container. To prevent this, you must create a “Volume” where n8n can safely store its data.
Open your terminal and run:
Bash
docker volume create n8n_data
You can verify this worked by checking the Volumes tab in your Docker Desktop UI [05:42].
Step 3: Pull and Run the n8n Container
Now, it’s time to fire up n8n. Run the following command in your terminal:
Bash
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
- What this does: It fetches the latest stable n8n image, maps it to port
5678, and connects it to the data volume you just created [06:12].
Step 4: Access Your Local Instance
Once the terminal shows that n8n is running, open your browser and go to: http://localhost:5678
Just like the Cloud and NPM versions, you’ll be asked to set up an owner account. Even if you’ve installed n8n on this machine before via NPM, Docker treats this as a fresh, isolated installation [07:06].
Managing Your Container
The beauty of Docker Desktop is the visual interface. You can head to the Containers tab to see:
- Resource Usage: Monitor how much CPU and RAM n8n is consuming [08:48].
- Controls: You can stop, start, or delete your n8n instance with a single click [09:07].
Final Thoughts
Whether you choose n8n Cloud for simplicity, NPM for lightweight local testing, or Docker for robust self-hosting, the power of AI automation is now at your fingertips. For most users looking to eventually move their automations to a private server, learning the Docker method is a highly valuable skill.
Watch the full video tutorial here: Install n8n using Docker Desktop
