INSTALL GUIDE • N8N

Install n8n with official npm docs and OS-specific commands

Exact install commands, expected output, and fail-fix blocks.

OFFICIAL DOC

Open https://docs.n8n.io/hosting/installation/npm/. This page confirms npm install and localhost:5678 default.

PREREQUISITE CHECK

node -v
npm -v

Expected result: Node and npm versions print. n8n docs require Node between 20.19 and 24.x.

Troubleshooting: Install Node LTS from nodejs.org/download then rerun checks.

WINDOWS

npm install n8n -g
n8n --version
n8n start

Then open browser and go to http://localhost:5678.

Expected result: n8n editor opens.

Troubleshooting: Run Test-NetConnection -ComputerName localhost -Port 5678. If false, restart n8n with n8n start.

MACOS

npm install n8n -g
n8n --version
n8n start

Open http://localhost:5678.

Expected result: n8n loads in browser.

Troubleshooting: Run which n8n. If empty, open a new terminal and retry.

LINUX

npm install n8n -g
n8n --version
n8n start

Open http://localhost:5678.

Expected result: n8n editor appears.

Troubleshooting: Try one-time run with npx n8n to confirm command works.

After install, complete the use guide for real day-to-day tasks.

SEQUENCE

See the full Install → Use → Combine path.