In this post, we'll be looking at three different ways to install Node.js and its package manager, Node Package Manager, on macOS.  We will discuss how to install Node.js using mac-native package installer, homebrew, a 3rd party installer, Node Version Manager and how to hop between different Node.js versions using Node Version Manager

A simple guide on how to set up Node.js development environment on macOS.

Node.js is an open-source runtime environment, which allows developers to create networked applications and web-servers in JavaScript. The main thing to remember is that Node.js is 

, which means it can support hundreds of simultaneous calls in the event loop. Basically, this means that a Node-based server does not wait for an API to return data. You can see a great example of asynchronous programming in Node.js 

Node.js therefore shines in building fast, data-intensive, and real-time network applications, such as Uber and PayPal. However, you can also use Node.js to build your private blockchain.

When using Node.js, you’ll also need to use Node Package Manager, or 

 is a package management framework for Node.js. It provides a command line utility tool to install Node.js libraries and manage their versions and dependencies. If you’ve ever used other programming languages, such as Ruby or Python, then you’ll notice that 

In this post, we'll learn how to install Node.js and Node Package Manager (NPM) in a macOS environment.

By the end of this tutorial you will have a good grasp on the following:

This post is intended for complete beginners to JavaScript or for folks switching from Ruby or Python to JavaScript for their backend production. It doesn’t assume any background knowledge of JavaScript (although it doesn’t hurt to have some!). However, this tutorial will cover everything you need to know and hopefully will get you up to speed in no time!

To check whether you already have Node installed, open new 

If you have Node.js installed, it should output Node’s version. If you don’t, you’ll see one of the two messages, depending on whether you use 

That means that the command you are trying to run is not installed. But worry not, there are several ways to install Node.js and NPM:

1) Using the macOS installer available from the Node.js website

 where you can download a pre-built installer for your mac platform.

There are two types of Node.js releases: 

. LTS releases are more polished and bug-free and will suffice for the majority of everyday users. Current releases are typically more experimental and contain the latest features, which may not be completely finished and could occasionally crash. You can switch between LTS and current versions by highlighting the field in the first tab. Again, the LTS version is recommended for most users. Therefore, if the LTS tab is highlighted in dark green, you can simply click on the macOS Installer option, which will download the 

This installer will also automatically install NPM for you. Just follow these steps:

 or some other version of the software that's just been installed.

Homebrew is arguably the most popular package manager for macOS and makes installing Node.js straightforward. Let's check whether you have Homebrew installed:

If Homebrew is installed on your mac, you should see its version, for example, 

. If not, you can install Homebrew with the following command:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/
Homebrew/install/master/install)"

Assuming that Homebrew is already installed, type:

While using Homebrew for Node.js installation is very easy, it comes with one disadvantage:

Unfortunately, Homebrew has a habit of installing only the latest version of Node.js.

This could be a problem because sometimes applications require a certain version of Node.js to work. Having the flexibility of using specific versions can be an asset. To fix this problem, the best option to install Node.js is via 

 to install and update Node.js (recommended)

, is a bash script to manage multiple active Node.js versions. It is easy to run with the following steps:

Congratulations, you have now successfully installed and understood the ins and outs of Node.js and NPM. 

I’ve helped you to explore some very basic commands, but please don’t stop here. It’s just the beginning and it’s up to you where this journey will take you!

<h1 data-node-type="titlePlaceholder" class="titlePlaceholder">How to install Node.js and npm on macOS</h1><div data-node-type="summary" class="summary-block">In this post, we'll be looking at three different ways to install Node.js and its package manager, Node Package Manager, on macOS.  We will discuss how to install Node.js using mac-native package installer, homebrew, a 3rd party installer, Node Version Manager and how to hop between different Node.js versions using Node Version Manager</div><blockquote><p>A simple guide on how to set up Node.js development environment on macOS.</p></blockquote><p>Node.js is an open-source runtime environment, which allows developers to create networked applications and web-servers in JavaScript. The main thing to remember is that Node.js is <strong>asynchronous</strong> and <strong>event-driven</strong>, which means it can support hundreds of simultaneous calls in the event loop. Basically, this means that a Node-based server does not wait for an API to return data. You can see a great example of asynchronous programming in Node.js <a href="https://www.newline.co/@AoX04/nodejs-tutorial-how-javascript-on-the-backend-can-make-your-life-easier--714b9ba9" rel="noopener noreferrer nofollow">here.</a></p><p style="line-height: 1.38;">Node.js therefore shines in building fast, data-intensive, and real-time network applications, such as Uber and PayPal. However, you can also use Node.js to build your private blockchain.</p><p>When using Node.js, you’ll also need to use Node Package Manager, or <code>npm</code> for short. <code>npm</code> is a package management framework for Node.js. It provides a command line utility tool to install Node.js libraries and manage their versions and dependencies.&nbsp;If you’ve ever used other programming languages, such as Ruby or Python, then you’ll notice that <code>npm</code> is analogous to <code>rubygems</code> in Ruby or <code>pip</code> / <code>poetry</code> in Python.</p><p>In this post, we'll learn how to install Node.js and Node Package Manager (NPM) in a macOS environment.</p><div data-panel-type="info" data-panel-position="inline" class="panel panel-type-info panel-position-inline"><div class="panel-container lolwut"><h2><a name="what-you-will-learn">What you will learn:</a></h2><p>By the end of this tutorial you will have a good grasp on the following:</p><ul><li><p>How to install Node.js and NPM using the macOS installer available from the Node.js website </p></li><li><p>How to install Node.js and NPM using <code>homebrew</code>, arguably the most popular package manager for macOS</p></li><li><p>How to install Node.js and NPM using Node Version Manager, or <code>nvm</code> for short. This is by far the best method to set up Node.js on your system because it gives you control and flexibility when hopping between different projects and their requirements.</p></li><li><p>How to switch between different Node.js versions using <code>nvm</code></p></li></ul></div></div><p>This post is intended for complete beginners to JavaScript or for folks switching from Ruby or Python to JavaScript for their backend production. It doesn’t assume any background knowledge of JavaScript (although it doesn’t hurt to have some!). However, this tutorial will cover everything you need to know and hopefully will get you up to speed in no time!</p><p>Ready? Let’s jump in.</p><p>To check whether you already have Node installed, open new <em>terminal</em> window and type:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-_5KWB" id="cm-_5KWB">node -v</textarea><p style="line-height: 1.38;">If you have Node.js installed, it should output Node’s version. If you don’t, you’ll see one of the two messages, depending on whether you use <code>bash</code><em> or</em> <code>zsh</code> shell:</p><p style="line-height: 1.38;">- <code>bash: command not found: node</code></p><p style="line-height: 1.38;">- <code>zsh: command not found: node</code></p><p>That means that the command you are trying to run is not installed. But worry not, there are several ways to install Node.js and NPM:</p><ol><li><p style="line-height: 1.38;"><strong>using the macOS installer available from the Node.js <a href="https://nodejs.org/en/download/" rel="noopener noreferrer nofollow">website</a> </strong></p></li><li><p><strong>using <code>homebrew</code> </strong></p></li><li><p><strong>using Node Version Manager (recommended)</strong></p><p></p></li></ol><p style="line-height: 1.38;">I’ll go over each method step-by-step.</p><h2><a name="1-using-the-macos-installer-available-from-the-nodejs-website">1) Using the macOS installer available from the Node.js website</a></h2><p>Visit the Node.js <a href="https://nodejs.org/en/download/" rel="noopener noreferrer nofollow">website</a> where you can download a pre-built installer for your mac platform.</p><p>There are two types of Node.js releases: <strong>long-term support (LTS)</strong> and <strong>current</strong>. LTS releases are more polished and bug-free and will suffice for the majority of everyday users. Current releases are typically more experimental and contain the latest features, which may not be completely finished and could occasionally crash. You can switch between LTS and current versions by highlighting the field in the first tab. Again, the LTS version is recommended for most users. Therefore, if the LTS tab is highlighted in dark green, you can simply click on the macOS Installer option, which will download the <code>.pkg </code>installer for Node.js.</p><p></p><figure class="photo figure-position-inline"><img src="https://s3.amazonaws.com/assets.fullstack.io/n/20200617173023934_start.png" attachmentid="bd44a8d6-e857-4eb8-a6dc-7656e2d611a1" contenteditable="false" data-width="1950" data-height="1750"><div></div></figure><p></p><p>This installer will also automatically install NPM for you. Just follow these steps:</p><ol><li><p>Download the Node.js <code>.pkg</code> Installer:</p><ul><li><p>Opening <code>node-v12.18.0.pkg</code></p><ul><li><p>Select <em>Open with Installer (default)</em></p></li></ul></li></ul></li><li><p>Run the <code>.pkg</code> Installer and follow the instructions that will guide you through the interface:</p><ul><li><p>Introduction</p><ul><li><p>Select <em>Continue</em></p></li></ul></li><li><p>License</p><ul><li><p>Select <em>Continue</em></p></li><li><p>Select <em>Agree</em></p></li></ul></li><li><p>Installation Type</p><ul><li><p>Select <em>Install</em></p></li><li><p>Authenticate using your macOS password to install the software</p></li><li><p>Select <em>Install Software</em></p></li></ul></li><li><p>Summary; you should see that Node.js and <code>npm</code> were installed</p><ul><li><p>Select <em>Close</em></p></li></ul></li></ul></li><li><p>Double-check that Node.js and NPM were installed:</p></li></ol><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-oLtRY" id="cm-oLtRY">node -v</textarea><p>You should now see output <code>v12.18.0</code> or some other version of the software that's just been installed.</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-QYs0q" id="cm-QYs0q">npm -v</textarea><p>You should now see output <code>6.14.5</code> which represents the NPM version.</p><h2><a name="2-using-homebrew-to-install-and-update-nodejs">2) Using <code>homebrew</code> to install and update Node.js</a></h2><p>Homebrew is arguably the most popular package manager for macOS and makes installing Node.js straightforward. Let's check whether you have Homebrew installed:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-UozS1" id="cm-UozS1">brew -v</textarea><p>If Homebrew is installed on your mac, you should see its version, for example, <code>Homebrew 2.3.0</code>. If not, you can install Homebrew with the following command:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-r3g89" id="cm-r3g89">/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/
Homebrew/install/master/install)"</textarea><p>Assuming that Homebrew is already installed, type:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-jHrC3" id="cm-jHrC3">brew update
brew install node</textarea><p>And that’s all you need. Again, try <code>node -v</code> to confirm Node.js version and <code>npm -v</code> to confirm NPM version.</p><p style="line-height: 1.38;">While using Homebrew for Node.js installation is very easy, it comes with one disadvantage:</p><div data-panel-type="info" data-panel-position="inline" class="panel panel-type-info panel-position-inline"><div class="panel-container lolwut"><p style="line-height: 1.38;"><strong>Unfortunately, Homebrew has a habit of installing only the latest version of Node.js.</strong></p></div></div><p style="line-height: 1.38;">This could be a problem because sometimes applications require a certain version of Node.js to work. Having the flexibility of using specific versions can be an asset. To fix this problem, the best option to install Node.js is via <code>nvm</code>, which stands for Node Version Manager.</p><p></p><h2><a name="3-using-nvm-to-install-and-update-nodejs-recommended">3) Using <code>nvm</code> to install and update Node.js (recommended)</a></h2><p><a href="https://github.com/nvm-sh/nvm" rel="noopener noreferrer nofollow">Node Version Manager</a>, <code>nvm</code>, is a bash script to manage multiple active Node.js versions. It is easy to run with the following steps:</p><ol><li><p>Open new <em>terminal</em> window</p></li><li><p>Run <code>nvm</code> install script</p><ul><li><p>The script clones the nvm repository to <code>~/.nvm</code> and adds the source lines to your shell profile, which is one the following: <code>~/.bash_profile</code>, <code>~/.zshrc,</code> <code>~/.profile,</code> or <code>~/.bashrc</code>. You can use either <code>curl</code> or <code>wget</code>, depending on what you have on your computer: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-7xCUn" id="cm-7xCUn">curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/
install.sh | bash</textarea><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-basRV" id="cm-basRV">wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/
install.sh | bash</textarea></li><li><p>You can also add the source lines manually. Open your shell profile, which is one the following: <code>~/.bash_profile</code>, <code>~/.zshrc,</code> <code>~/.profile,</code> or <code>~/.bashrc</code>. Since I use zsh shell, I would do: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-MrEIQ" id="cm-MrEIQ">vim .zshrc</textarea></li><li><p>This command opens your shell profile. Then copy and paste the following:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-ClKD0" id="cm-ClKD0">export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] &amp;&amp; \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] &amp;&amp; \. "\$NVM_DIR/bash_completion"

# This loads nvm bash_completion</textarea></li><li><p>Close the vim file by pressing: <code>:</code> + <code>esc</code> + <code>w</code> + <code>q</code></p></li></ul></li><li><p>Reload the shell configuration by using the following command</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-Q1197" id="cm-Q1197">source ~/.zshrc</textarea></li><li><p>Verify the installation</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-okJZ2" id="cm-okJZ2">command -v nvm</textarea></li><li><p>This should print <code>nvm</code> if the installation was successful.</p></li><li><p>Use <code>nvm</code> to install Node.js. There are several commands you will find handy</p><ul><li><p>List all command options by using: <code>nvm</code> + <code>tab key</code> </p><figure class="photo figure-position-inline"><img src="https://s3.amazonaws.com/assets.fullstack.io/n/20200617173111610_nvm-summary.png" attachmentid="6f5cf3c4-6ccb-465d-bed4-7453f98c0556" contenteditable="false" data-width="1080" data-height="168"><div></div></figure></li><li><p>Download, compile, and install the latest release of node: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-Oka7C" id="cm-Oka7C">nvm install node</textarea><p>Here <code>node</code> is an alias for the latest version</p></li><li><p>Install the specific version, for example v12.18.0: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-UXtts" id="cm-UXtts">nvm install v12.18.0</textarea></li><li><p>Next, you actually have to <em>use</em> that specific version of Node that you just installed:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-8Hj5H" id="cm-8Hj5H">nvm use v12.18.0</textarea></li><li><p>Print the path to the executable file where the specific version was installed: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-BpAr1" id="cm-BpAr1">nnvm which 12.18.0</textarea></li><li><p>Change the default Node.js version, let's say from 12.18.0  to 10.20.1: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-ITMTb" id="cm-ITMTb">nvm alias default 10.16.3</textarea></li><li><p>Migrate packages from a previous Node.js version: <code>nvm install node --reinstall-packages-from=node</code>, for example: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-JF4zu" id="cm-JF4zu">nvm install v12.18.0 --reinstall-packages-from=v10.20.1</textarea></li><li><p>Delete an older version of Node.js: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-wbdhk" id="cm-wbdhk">nvm uninstall v10.20.1</textarea></li><li><p>Install and use the LTS version: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-dlZz9" id="cm-dlZz9">nvm install --lts
nvm use --lts</textarea></li><li><p>List all installed Node.js versions available locally on your machine: </p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-VqLr6" id="cm-VqLr6">nvm list</textarea></li></ul><figure class="photo figure-position-inline"><img src="https://s3.amazonaws.com/assets.fullstack.io/n/20200617173259198_nvm-list.png" attachmentid="eb45a745-301a-4f42-9a58-e76050e4b78d" contenteditable="false" data-width="576" data-height="368"><div></div></figure></li><li><p>Finally, use <code>nvm</code> to install NPM</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-yR9MT" id="cm-yR9MT">nvm install-latest-npm</textarea><p>Please note that this installs the latest working NPM on the node version that you're <em>currently using</em>, such as <code>~/.nvm/versions/node/[your-version]/lib/node_modules/npm</code>. This is something you want because you want to update the NPM and packages only for that Node.js version which is associated with a specific project and its requirements. Once you have NPM set up, there are several handy commands you can check out:</p><ul><li><p>List globally installed packages:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-VNSY4" id="cm-VNSY4">npm ls -g --depth=0.</textarea></li><li><p>Update all globally installed packages:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-FwfO2" id="cm-FwfO2">npm update -g</textarea><p>Again, note that this will update packages inside the path of your active Node.js version instead of the system global path.</p></li></ul></li></ol><p>Congratulations, you have now successfully installed and understood the ins and outs of Node.js and NPM. </p><div data-panel-type="info" data-panel-position="inline" class="panel panel-type-info panel-position-inline"><div class="panel-container lolwut"><h2><a name="here-is-what-you-have-learned">Here is what you have learned:</a></h2><ul><li><p>You have seen the installation of Node.js via the mac installer</p></li><li><p>You also have seen the installation of Node.js via <code>homebrew</code>, arguably the most popular package manager for macOS</p></li><li><p>However, the best way to install Node.js is using Node Version Manager. This gives you additional control and flexibility when it comes to customizing different Node.js versions, which might be needed if you are hopping between different projects and their requirements.</p></li></ul></div></div><p style="line-height: 1.38;">I’ve helped you to explore some very basic commands, but please don’t stop here. It’s just the beginning and it’s up to you where this journey will take you!</p><p></p><p></p><p></p><p></p><p></p>

Learn

The newline Guide to Building Your First GraphQL Server with Node and TypeScript

Teach

Amelia Wattenberger

Author of Fullstack D3

Community

How to install Node.js and npm on macOS

Responses (4)

Masterclasses

Tutorials

Fullstack React with TypeScript