How to Install Node.js: A Step-by-Step Guide
Learn to install Node.js on Windows, macOS, and Linux using official installers or a version manager. This beginner-friendly guide covers verification, npm basics, and maintenance for a reliable development environment.
You will learn how to install Node.js on Windows, macOS, or Linux, verify the installation, and run a simple hello world project. This guide covers official installers, version managers like nvm, and package managers to ensure a clean, maintainable setup. By the end, you’ll have a ready-to-use Node.js environment for web apps, tooling, and learning projects.
What Node.js is and why you should install it
Node.js is a JavaScript runtime built on the V8 engine that lets you run JavaScript outside of a browser. It powers servers, tooling, and desktop automation, making it essential for modern web development. If you’re pursuing full‑stack work, automating builds, or creating command-line tools, learning how to install node js is a foundational skill. Node.js comes with npm, a package manager that lets you pull in thousands of libraries. This section will outline what Node.js does, why it matters for developers, and how a solid installation sets the stage for reliable projects. The goal is to give you confidence that you can set up a clean environment on your platform and start shipping small apps quickly.
Choosing your installation method: installer vs version manager
There are multiple ways to install Node.js, and your choice affects maintenance, updates, and the ability to run multiple versions. For beginners, the official LTS installer is the simplest path to a stable runtime. If you anticipate needing to switch between Node versions for different projects, a version manager like nvm (for
Windows installation using the official installer
Windows users can install Node.js using the official Windows installer from the Node.js site. The setup wizard guides you through the process, including whether to install npm and the PATH updates. Choose the LTS version for maximum stability, and allow the installer to configure your environment. After installation, you can open Command Prompt or PowerShell to verify the versions and start a quick test project. This route is straightforward and minimizes surprises for beginners.
Linux installation options: apt/yum and nvm
Linux users typically install Node.js via a package manager (apt for Debian/Ubuntu, yum/dnf for Fedora/RHEL) or through a version manager like nvm. The package manager often ships a stable version, but it may lag behind the latest LTS. If you plan to work with multiple projects or need to test across versions, nvm is a strong choice: it lets you install and switch between multiple Node versions without affecting the system Python or npm. Always update your package index before installation.
Verifying the installation and basic usage
After installation, verify the runtime by running node -v and npm -v in your terminal. You should see version numbers, confirming a successful setup. Create a quick test file (for example, a hello.js containing console.log('Hello Node')) and run it with node hello.js to see Node.js in action. This hands-on step confirms the environment is ready for development tasks like building APIs, running build tools, or exploring npm packages.
Common pitfalls and how to avoid them
Be mindful of PATH configuration, especially on Windows where the installer offers to add Node.js to PATH. If you skip this, your system won’t recognize node or npm. Avoid mixing system-level packages with nvm-managed versions. If you encounter permissions errors on Linux, avoid using sudo for npm install -g; instead, adjust directory permissions or use a Node version manager. Finally, always install the LTS version to minimize breaking changes in projects.
Next steps: creating a small project and exploring npm
With Node.js installed, a practical next step is to scaffold a tiny project: create a folder, initialize npm (npm init -y), and write a small script that logs a message. Then install a tiny package (npm install say-hello) and run it. This hands-on practice helps you understand package.json, dependencies, and scripts. As you grow, explore popular frameworks and CLI tools to speed up development.
Authority sources
- https://nodejs.org/en/
- https://nodejs.org/en/download/
- https://docs.npmjs.com/
Tools & Materials
- Official Node.js installer(Choose the LTS version for stability)
- Terminal or Command Prompt(Admin rights may be required on Windows)
- Text editor (optional but recommended)(Examples: VS Code, Sublime Text)
- NVM or Homebrew (macOS)(Use for managing multiple Node.js versions)
- Internet connection(To download installers and packages)
Steps
Estimated time: 30-60 minutes
- 1
Choose your installation method
Decide whether to use the official installer for your OS or a version manager like nvm for easier version control.
Tip: For beginners, start with the official LTS installer; you can switch later with a version manager. - 2
Download installer or install nvm
On Windows/macOS/Linux, download the installer from the official Node.js site or install nvm to manage versions.
Tip: Verify you download from nodejs.org to avoid tampered software. - 3
Run the installer (Windows) / Setup (macOS/Linux)
Run the installer and follow prompts; select defaults unless you have a compelling reason to customize. On macOS/Linux, you may install via package manager or curl script.
Tip: Keep the default installation paths unless you have custom preferences. - 4
Verify Node.js and npm versions
Open a terminal and run 'node -v' and 'npm -v' to confirm the installation. If versions show up, you're ready to proceed.
Tip: If npm is missing, re-run the installer or install npm separately. - 5
Create a test project
Create a folder, initialize with npm, and write a simple script to print a message using Node.js.
Tip: Use 'npm init -y' for a quick setup and save time. - 6
Learn basic npm usage
Install a tiny package and run a script to understand package management.
Tip: Avoid globally installing packages unless necessary.
Got Questions?
Do I need Node.js to run JavaScript on the browser?
No, browser JavaScript runs without Node.js. Node.js provides a runtime for server-side tasks and tooling.
No—Node.js isn't required for browser code, but it's essential for servers and development tools.
Which installation method should I choose?
If you plan to work on multiple projects or switch Node versions, use a version manager like nvm. For beginners, the official LTS installer is simplest.
If you’re new, start with the official LTS installer; use nvm later if you need multiple versions.
How do I update Node.js later?
Use the same installer or a version manager to upgrade to a newer LTS release. With nvm, you can install multiple versions and switch as needed.
You can update by re-installing via the official site or using nvm to switch versions.
What versions should I install?
The recommended version is the latest LTS release, which balances stability and features.
Go with the latest LTS to get a stable, supported toolset.
Is npm required?
npm is included with Node.js installers. If it’s missing, re-run the installer or install npm separately.
Yes, npm comes bundled with Node.js or can be installed separately if needed.
Main Points
- Install Node.js from official sources for safety
- Choose an installation method that fits version needs
- Verify npm and Node.js after install
- Start a simple project to learn npm basics
