Node.js lets you run JavaScript on your computer, not just in browsers. It's essential for web development, and it's pretty easy to set up. I've installed Node.js dozens of times, and I'm going to show you the easiest way.

By the end of this guide, you'll have Node.js installed, verified, and ready to use.

What is Node.js?

Node.js is a JavaScript runtime - it lets you run JavaScript code on your computer. You need it for:

• Building web applications
• Using npm (Node Package Manager) to install packages
• Running JavaScript tools and frameworks
• Backend development

Step 1: Download Node.js

Windows and Mac:

1. Go to nodejs.org
2. Download the LTS (Long Term Support) version - it's the stable one
3. Run the installer
4. Use the default options - they're fine

The installer includes Node.js and npm (Node Package Manager). Both get installed together.

Mac alternative: If you use Homebrew, you can install with brew install node

Step 2: Verify Installation

Open Command Prompt (Windows) or Terminal (Mac) and check:

node --version

You should see something like "v20.10.0" (version might be different). If you see this, Node.js is installed!

Also check npm:

npm --version

You should see npm's version. npm comes with Node.js, so if Node.js works, npm should too.

Step 3: Test Node.js

Let's make sure it actually works:

node

You should see the Node.js prompt (>). Type:

console.log("Hello, Node.js!")

Press Enter. You should see "Hello, Node.js!" printed. Type .exit or press Ctrl+C twice to leave.

Step 4: Create Your First Node.js File

Create a file called hello.js and type:

console.log("Hello from Node.js!")

Save it, then run:

node hello.js

You should see "Hello from Node.js!" printed. Congratulations - you just ran a Node.js program!

Using npm

npm lets you install packages (libraries) for your projects:

Install a package:

npm install package-name

Initialize a project:

npm init

This creates a package.json file that tracks your project's dependencies.

Install and save to package.json:

npm install package-name --save

The --save flag adds it to your package.json (it's the default now, so you can omit it).

Common Issues and Fixes

• "node is not recognized": Node.js isn't in your PATH. Restart your terminal/command prompt. If that doesn't work, reinstall Node.js and make sure to check "Add to PATH" during installation.
• Permission errors on Mac/Linux: Don't use sudo with npm install. If you get permission errors, fix npm's permissions or use a node version manager.
• Old version: Make sure you downloaded the latest LTS version from nodejs.org.
• npm not found: npm comes with Node.js. If npm doesn't work, Node.js might not be installed correctly. Reinstall Node.js.

Using nvm (Node Version Manager) - Optional

nvm lets you install and switch between multiple Node.js versions. Useful if you work on different projects:

Install nvm:

• Mac/Linux: Go to github.com/nvm-sh/nvm for installation instructions
• Windows: Use nvm-windows from github.com/coreybutler/nvm-windows

Use nvm:

nvm install node        # Install latest
nvm install 20.10.0     # Install specific version
nvm use 20.10.0         # Switch to version
nvm list                # List installed versions

nvm is useful but not necessary for beginners. You can install it later if you need multiple versions.

Next Steps

Now that Node.js is installed:

• Start learning JavaScript/Node.js
• Create your first Node.js project
• Install useful packages with npm
• Build web applications

Check out our web development courses to get started!