Installing Node.js Tutorial: macOS
Just like any programming language, platform, or library, getting up and running with Node.js takes some initial setup before you can start hacking away. With Node.js, the only initial setup required is, quite simply, getting the binary installed.
In this quick tutorial, we'll take a quick look at how to get Node.js on macOS. Once we've completed the entirety of the tutorial, you'll be ready to take the next step with Node.js.
This guide covers installing Node.js on the following versions of OS X and macOS: OS X 10.10 (Yosemite), OS X 10.11 (El Capitan), and macOS 10.11. These are the versions that are consistently tested and supported by the Node.js build process at the time of writing.
Step 0: The Quick Guide (TL;DR) to Get Node.js Installed on macOS
Here's the abbreviated guide, highlighting the major steps:
- Go to the Node.js Downloads page
- Download Node.js for macOS by clicking the "Macintosh Installer" option
- Run the downloaded Node.js
- Run the installer, including accepting the license, selecting the destination, and authenticating for the install.
- You're finished! To ensure Node.js has been installed, run
node -vin your terminal - you should get something like
Step 1: Download the Node.js
As our first step, we need to actually get the official installer for Node.js on macOS. To do so, we can head over to the Node.js Downloads page to download the installer.
You can get the macOS installer by clicking the
Macintosh Installer option - this will download the
.pkg installer for Node.js. Make sure you save it somewhere that you'll be able to access it!
Step 2: Run the Node.js Installer
Now that you've got the installer downloaded, you'll need to run it. The installer is a pretty typical interface - it won't take long to get through it (under a minute), even though there are a few parts to it. You can get through it by following the guide below:
- Installation Type
- Authenticate with your Mac to allow the Installation
Step 3: Verify that Node.js was Properly installed
To verify that Node.js was installed correctly on your Mac, you can run the following command in your terminal:
$ node -v
If Node.js was properly installed, you'll see something close to (but probably not exactly) this:
$ node -v // The command we ran - tests the version of Node.js that's currently installed v6.9.4 // The version of Node.js that's installed - v6.9.4 was the most current LTS release at the time of writing.
Step 4: Update Your npm Version
As one last step for good measure, we'll update your version of npm.
Node.js always ships with a specific version of npm - Node.js doesn't (and shouldn't!) automatically update npm. The npm releases aren't synced with Node.js releases. Because of this, there's almost always a newer version of npm than the one that is installed by default with a given version of Node.
To easily update your version of
npm, you can run the following command:
$ sudo npm install npm --global // Update the `npm` CLI client
Step 6: Start building with Node.js!
Now you've got Node.js on your Mac. It's time to start exploring!
That said, if you want to keep in touch with Node.js and the surrounding ecosystem, you should go follow @NodeSource on Twitter! We'll keep you updated with important news from the Node.js project, and share the best Node.js tutorials, guides, and tools that the community has to offer!