Run n8n Locally for Free with Docker (Part 2 of 10): Installing Docker Desktop on Windows, Mac, and Linux
By Abhishek Patoliya · 2026-08-12
This is Part 2 of the series on running n8n locally with Docker for free. Before n8n enters the picture at all, you need Docker itself running on your machine — this part covers installing it on Windows, Mac, and Linux, and confirming it actually works.
← Back to the full series index
Windows
- Download Docker Desktop from Docker's official site and run the installer.
- Docker Desktop on Windows needs WSL2 (Windows Subsystem for Linux) — the installer offers to enable this automatically if it isn't already; accept it and restart when prompted.
- After the restart, launch Docker Desktop and wait for the whale icon in the system tray to show it's running (not just starting).
If the installer reports that virtualization isn't enabled, you'll need to enable it in your BIOS/UEFI settings (usually labeled "Intel VT-x" or "AMD-V") before Docker Desktop can start.
Mac
- Download Docker Desktop for Mac, choosing the Apple Silicon or Intel build that matches your chip.
- Drag it into Applications and launch it.
- Grant the permissions it requests on first launch — these are needed for Docker's networking and file-sharing features.
No virtualization toggle is needed on Mac — Apple's hypervisor framework handles this automatically.
Linux
Linux doesn't need Docker Desktop at all — installing Docker Engine directly is the standard approach and works identically for everything in this series. On Ubuntu/Debian-based distributions:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
Log out and back in after that last command — it adds your user to the docker group so you don't need sudo before every docker command.
Confirming It Actually Works
Regardless of platform, open a terminal and run:
docker --version
docker run hello-world
The first command should print a version number. The second downloads a tiny test image and prints a message confirming your installation is working — if you see that message, Docker is correctly installed and ready for n8n.
Common Install Issues
- "Docker daemon is not running" — Docker Desktop needs to be actually open and fully started (not just installed) before any docker command works. Check the tray/menu bar icon.
- WSL2 installation fails on Windows — this usually means virtualization is disabled in BIOS, or Windows itself needs an update; Docker's installer error message typically names which one.
- Permission denied running docker on Linux — you likely skipped the
usermod -aG docker step above, or haven't logged out and back in since running it.
Next Up
With Docker confirmed working, Part 3: Your First n8n Container covers the actual command that gets n8n running for the first time.
Written by Abhishek Patoliya, Senior n8n Developer & Automation Architect, Surat, India. Verified n8n Creator.