sodcalculator

10 Tech How-To

Install n8n on Windows: Step-by-Step Guide

Guide 10-43082 · Updated · Step by step

Yes, you can install n8n on Windows, and the easiest way is to run it in Docker Desktop. This guide walks you through the two most reliable methods—Docker (recommended) and native installation via Node.js—so you can start building workflow automations on your Windows machine.

What Is n8n and Why Run It on Windows?

n8n is a fair-code workflow automation tool that lets you connect apps and services (like Google Sheets, Slack, and APIs) without writing code from scratch. It runs as a server on your computer, giving you full control over your data and workflows. Running it on Windows is common for developers, hobbyists, and small teams who want to prototype automations locally before deploying to a cloud server.

There are two main ways to install n8n on Windows:

  • Docker Desktop – the recommended method, because it isolates n8n and its dependencies in a container, making updates and removal clean.
  • Native with Node.js – install n8n directly as an npm package, which works but requires you to manage Node.js and dependencies yourself.

Prerequisites for Both Methods

Before you start, make sure your Windows machine meets these requirements:

  • Windows 10 or 11 (64-bit)
  • At least 4 GB of RAM (8 GB recommended)
  • Stable internet connection for downloading packages
  • Administrator access to install software

If you choose Docker, you’ll also need to enable virtualization in your BIOS (usually already on) and have Windows Subsystem for Linux 2 (WSL2) available. Docker Desktop will guide you through enabling WSL2 if it’s not already set up.

Method 1: Install n8n with Docker Desktop (Recommended)

Docker is the cleanest way to run n8n on Windows because it bundles everything n8n needs. Here’s how to do it:

  1. Download and install Docker Desktop from the official Docker website. Run the installer and follow the prompts. You may need to restart your computer after installation.
  2. Launch Docker Desktop from the Start menu. It will start in the background and show a whale icon in the system tray. Wait until it says “Engine running” (this can take a minute on first launch).
  3. Open a terminal (PowerShell or Command Prompt) and run the following command to pull and run the n8n container:
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n

Let’s break down what that command does:

  • -it – runs the container in interactive mode so you see logs.
  • --rm – removes the container when you stop it (your data is still saved in the volume).
  • --name n8n – gives the container a name for easy management.
  • -p 5678:5678 – maps port 5678 on your PC to port 5678 in the container (this is the n8n web interface port).
  • -v n8n_data:/home/node/.n8n – creates a named volume that persists your workflows and credentials even if you recreate the container.

After the command runs, you’ll see logs from n8n. Open your browser and go to http://localhost:5678. You should see the n8n editor. That’s it—you’re running n8n on Windows!

Method 2: Install n8n Natively with Node.js

If you prefer not to use Docker, you can install n8n directly using Node.js. This method is more involved because you manage n8n as a regular application.

  1. Install Node.js from the official website (choose the LTS version). The installer will also install npm (Node Package Manager).
  2. After installation, open a new terminal (PowerShell) and verify Node.js is installed by running node --version. You should see a version number like v20.x.x.
  3. Install n8n globally with npm:
npm install n8n -g

This downloads and installs n8n and its dependencies. It may take a few minutes.

  1. Start n8n by running:
n8n start

You’ll see output showing that n8n is running on port 5678. Open http://localhost:5678 in your browser to access the editor.

To stop n8n, press Ctrl+C in the terminal. To start it again later, just run n8n start again.

How to Choose Between Docker and Native Installation

Your choice depends on how you plan to use n8n:

  • Choose Docker if: you want the easiest updates (just pull a new image), you plan to run other services alongside n8n, or you want to avoid cluttering your system with Node.js packages.
  • Choose native if: you already have Node.js installed, you need to customize n8n’s source code, or you have limited disk space (Docker images can be large).

For most users, Docker is the better long-term choice because it keeps n8n isolated and makes it easy to back up your data (the volume). Native installation is fine for quick experiments, but you’ll need to manually update n8n with npm update -g n8n.

Common Problems and How to Fix Them

Even with a straightforward install, you might hit a few snags. Here are the most common issues and their solutions:

  • Port 5678 is already in use – If you see an error like “EADDRINUSE” or the browser won’t load, another program is using that port. You can change the port by adding -p 5679:5678 in Docker (and accessing http://localhost:5679) or by setting the environment variable N8N_PORT=5679 for native installs.
  • Docker Desktop won’t start – Make sure virtualization is enabled in your BIOS. Also, check that Windows Hyper-V and Windows Hypervisor Platform are turned on (you can enable them via “Turn Windows features on or off” in Control Panel).
  • npm install fails – This is often due to network issues or permissions. Try running the terminal as Administrator, or clear the npm cache with npm cache clean --force.
  • n8n starts but the browser shows “Connection refused” – Wait a few seconds for the server to fully start. Also, ensure you’re using http://localhost:5678 (not https).

If you still have trouble, check the n8n documentation or community forum—they have detailed troubleshooting guides.

Keeping n8n Updated and Managing Data

Updates are important for security and new features. Here’s how to update n8n:

  • Docker: Pull the latest image and recreate the container. The command is the same as the initial run, but you should first stop and remove the old container (if you used --rm, it’s already gone).
  • Native: Run npm update -g n8n to get the latest version.

Your workflows and credentials are stored in the ~/.n8n folder (on Windows, that’s C:\Users\YourUsername\.n8n). Back this up regularly if you have important workflows. In Docker, the data is inside the named volume n8n_data—you can back it up by copying the volume contents.

Frequently Asked Questions

Can I install n8n on Windows without Docker?

Yes, you can install n8n natively using Node.js and npm. The steps are outlined above in Method 2. It works fine, but you’ll need to manage Node.js updates and dependencies yourself.

Does n8n run on Windows 10?

Yes, n8n runs on Windows 10 and 11. Docker Desktop supports both, and Node.js also works on both. Just make sure you have the latest updates installed.

How do I access n8n from another device on my network?

By default, n8n listens on localhost only. To access it from another computer, you need to change the host setting. In Docker, add -e N8N_HOST=0.0.0.0 to the run command. For native, set the environment variable N8N_HOST=0.0.0.0 before starting. Then use your PC’s IP address (e.g., http://192.168.1.10:5678) from the other device.

Is n8n free to use on Windows?

Yes, n8n is free to use locally, even for commercial purposes, as long as you don’t offer it as a hosted service to others. The fair-code license allows you to use it internally without paying.

Can I run n8n as a Windows service so it starts automatically?

Yes, you can. For Docker, you can use Docker’s restart policy (--restart unless-stopped) to start the container on boot. For native, you can use a tool like NSSM (Non-Sucking Service Manager) to wrap the n8n start command as a Windows service.

What is the default username and password for n8n?

There is no default login. When you first open n8n in your browser, you’ll be asked to create an owner account with your email and password. This is your local admin account, so remember it.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →