How to Install & Run n8n Locally (Step-by-Step Guide)

This guide will walk you through how to install and run n8n on your local machine using Node.js and optionally Docker.

📍 Who is this for?

Beginners who want to explore automation

Developers testing locally before deploying

Non-technical folks curious about workflow tools

🧰 WHAT YOU'LL LEARN:

What is n8n?
Tools you need
How to install n8n locally on:

🪟 Windows (PowerShell)

🍎 Mac (Terminal or Docker)

How to launch n8n and start using it
Common errors and how to fix them

BENEFITS OF SELF-HOSTING LOCALLY

Full Data Control – Your data stays on your system.
No Monthly Fees – Completely free to run.
Offline Access – Use it without internet.
Hands-On Learning – Boost your tech skills fast.
Instant Testing – Changes reflect immediately.
Customizable – Tweak it to fit your needs.
Great for Portfolios – Show real-world setup skills.

🧠 1. WHAT IS N8N?

n8n (pronounced “n-eight-n”) is a free, open-source workflow automation tool. You can use it to connect apps, APIs, databases, and automate repetitive tasks all visually!

🧰 2. Tools You’ll Need (Both Platforms)

Tool Description

Node.js —-- Required to install and run n8n

npm—- Comes with Node.js (used to install packages)

PowerShell (for Windows) or Terminal (forMac) —-- For running commands
Browser —-- To access your local n8n dashboard

💻 3. Installing n8n on Windows (PowerShell Method)

🔹 STEP 1: INSTALL NODE.JS

Visit: https://nodejs.org
Download the LTS (Long-Term Support) version for Windows.
Install it (leave all settings default).
To confirm installation: Open PowerShell and type:

node -v
npm -v

🔹 Step 2: Open PowerShell as Administrator

Click Start.
Search PowerShell.
Right-click → “Run as Administrator”.

Or press the windows 🪟 button + x on your keyboard and it will take you straight to power shell administrator.

🔹 STEP 3: ALLOW SCRIPTS TO RUN

Type the following and press Enter:

Set-ExecutionPolicy RemoteSigned

When prompted, type:

🔹 STEP 4: INSTALL N8N GLOBALLY

In the same PowerShell window, type:

npm install -g n8n

⏳ Wait for the installation to finish. It might take a few minutes.

🔹 STEP 5: RUN N8N

After installation, type:

n8n

You should see:

n8n ready on http://localhost:5678/

🔹 STEP 6: OPEN IN BROWSER

Open your browser and go to:

http://localhost:5678/

You're now inside n8n! 🎉

It will prompt you to signup which is a very straightforward process.

Anytime you want to login after this time, open power shell administrator by simply pressing the windows + x buttons together on your keyboard, on the power shell windows type n8n and viola, you are in.

COMMON ERRORS & FIXES

Error Fix

👉 sudo: command not found (Windows) Use PowerShell as Administrator, don't use sudo

👉 Running scripts is disabled Run: Set-ExecutionPolicy RemoteSigned

👉 n8n not recognized

FIX Close and reopen terminal, or run: npx n8n
👉 npm WARN deprecated Safe to ignore

👉 Nothing happens after running n8n Be patient — it may be installing. If it returns to the prompt, use: npx n8n.

If you’re curious to learn more, replicate my setup, or build something togetherreach out! I’m happy to share the original documentation, help troubleshoot, or even co-create with other automation enthusiasts.

👩🏽‍💻 Posted by Annie Fortunate
🔗 https://www.linkedin.com/in/annie-dan
✉️ anniefortunate11@gmail.com