Switching between Node versions during development

Sometimes it seems like there are new versions of Node.js released almost weekly — minor versions every few weeks, major versions every few months. If you are a developer that needs to switch between different applications and projects on a regular basis, you may find you need to run different versions of Node.

Luckily, there are several decent ways to install multiple versions and switch as needed. This article will discuss and compare two popular Node version managers: NVM for Windows and the n Node version manager for Linux/Mac.

Tip: Different NVM implementations exist for Windows and Linux/Mac; however, the n npm package is only supported on Linux/Mac.

For comparison purposes, let’s pretend that you are working on two applications. Application 1 is an Angular 5 app running on Node 6.17.1. Application 2 is an Angular 7 app running on Node 8.16.0. Here is what you need to accomplish:

• Fix bug x on Application 1
• Upgrade Application 2 to Angular 8

You are actually going to need three versions of Node to complete your tasks since the Angular 8 upgrade will require you upgrade Application 2 to Node 10.9 or greater.

NVM for Windows

Technically, there are two completely separate NVM projects that offer similar capabilities on different operating systems but are maintained independent of each other:

• nvm-sh/nvm is a bash script that can be used to manage Node versions on Linux and Mac
• coreybutler/nvm-windows is a Windows application (with or without an installer) that can be used to managed Node versions on Windows

This article focuses on NVM for Windows.

Installation

Installation is as simple as downloading the NVM for Windows installer from the latest release on GitHub. At the time of writing, 1.1.7 (Aug. 2018) is the latest release. Download and extract nvm-setup.zip and double-click to the executable to install.

The installer will place NVM in an appropriate folder on your machine and update your system environment variables so that nvm and future installations of node are available on the command line.

Tip: If you prefer to install to your own folder, download nvm-noinstall.zip and extract it wherever you would like. Run the included install.cmd to set up necessary system environment variables.

Tip: Detailed installation instructions are available on GitHub .

Once installation is complete, open a command window and confirm NVM is available:

D:\>nvm version
1.1.7

Getting Application 1 running

If you recall, you need to work on two different applications with three different versions of Node to complete all of your tasks. Start by getting Application 1 running first. Some command output has been truncated ( ... ) to save space.

Front-end Application Monitoring

Identify Fix Track

Get a Free Trial >

D:\>nvm list available
|   CURRENT    |     LTS      |  OLD STABLE  | OLD UNSTABLE |
|--------------|--------------|--------------|--------------|
|    12.4.0    |   10.16.0    |   0.12.18    |   0.11.16    |
...
D:\>nvm install 6.17.1
Downloading node.js version 6.17.1 (64-bit)...
Complete
Creating C:\Users\Brian\Downloads\nvm-noinstall\temp

Downloading npm version 3.10.10... Complete
Installing npm v3.10.10...

Installation complete. If you want to use this version, type

nvm use 6.17.1
D:\>nvm use 6.17.1
D:\>nvm list
  * 6.17.1 (Currently using 64-bit executable)    
D:\>node -v
v6.17.1
D:\>cd application1
D:\application1>npm install
...
D:\application1>npm start
> [email protected] start D:\application1
> ng serve

** Angular Live Development Server is listening on localhost:4200, open your browser on http://localhost:4200/ **
...

Here are some of NVM’s key capabilities that you just took advantage of to get the application running:

nvm list available
nvm install
nvm use
nvm list

Once Node is installed and activated, then it is business as usual. You can follow whatever Node/npm workflow your application requires.

Tip: Your Node versions are completely isolated from each other. For example, if you install a package globally on one version of Node, that package won’t be available on other Node versions.

Getting Application 2 running

So you have fixed bug x in Application 1, and now you are ready to tackle upgrading Application 2 to Angular 8:

<strong>D:\nvm install 8.16.0</strong>
...
<strong>D:>nvm use 8.16.0</strong>
Now using node v8.16.0 (64-bit)
<strong>D:>cd application2</strong>
<strong>D:\application2>npm install</strong>
...
<strong>D:\application2>npm start</strong>
...
<strong>D:\application2>nvm install 10.16.0</strong>
...
<strong>D:\application2>nvm use 10.16.0</strong>
Now using node v10.16.0 (64-bit)
<strong>D:\application2>npm i -g @angular/cli@8</strong>
...
<strong>D:\application2>ng update @angular/cli @angular/core</strong>
...
<strong>D:\application2>npm install</strong>
...
<strong>D:\application2>npm start</strong>
...

With the help of NVM (and Angular CLI), you made quick work of the upgrade with a few commands:

• nvm install and nvm use installed and activated v8.16.0 so that you could verify that the application worked as expected before the upgrade
• nvm install and nvm use installed and activated v10.16.0 in preparation for the upgrade
• Globally installed the @angular/cli package to get access to the ng update command that automatically upgrades Angular applications
• npm install and npm start to test the newly upgraded application

n Node version manager

The n Node version manager provides a simpler CLI for installing and switching between Node versions. It is only supported on Linux or Mac operating systems.

Tip: Detailed installation and usage instructions are available in the tj/n repository on GitHub .

Installation

If you have a version of Node and npm installed already, you can install n just like any other NPM package using npm install -g n .

If you don’t already have a version of Node or npm installed, you can install n with a bash script from GitHub. Here is what it looks like:

Tip: You must have Git installed to install n with the bash script.

<strong>~$ curl -L https://git.io/n-install | bash</strong>
...
=== n successfully installed.
  The active Node.js version is: v10.16.0

  Run `n -h` for help.
  To update n later, run `n-update`.
  To uninstall, run `n-uninstall`.

  IMPORTANT: OPEN A NEW TERMINAL TAB/WINDOW or run `. /home/brian/.bashrc`
             before using n and Node.js.
===
<strong>~$ . /home/brian/.bashrc</strong>
<strong>~$ n</strong>
node/10.16.0

n is installed by downloading and running the n-install script from GitHub. After installation, running n demonstrates that a version of Node is installed by default.

Getting Application 1 running

Application 1 requires Node v6.17.1, so you need to install that first, then run the app.

<strong>~$ n 6.17.1</strong>
     install : node-v6.17.1
       mkdir : /home/brian/n/n/versions/node/6.17.1
       fetch : https://nodejs.org/dist/v6.17.1/node-v6.17.1-linux-x64.tar.gz
####################################################################################################################################### 100.0%
installed : v6.17.1
<strong>~$ node -v</strong>
v6.17.1
<strong>~$ cd application1</strong>
<strong>~/application1$ npm install</strong>
...
<strong>~/application1$ npm start</strong>
> [email protected] start ~/application1
> ng serve

** Angular Live Development Server is listening on localhost:4200, open your browser on http://localhost:4200/ **
...

The n command for installing and activating a version of Node is simple: n 6.17.1 . You could also use n latest for the latest version of Node or n lts for the latest LTS version of Node. If the version of Node is already installed, then n will simply switch to that version.

After installing Node, the application can be run as usual.

Tip: Similar to NVM, Node versions are completely isolated from each other. For example, globally installed packages are not shared between Node versions.

Getting Application 2 running

Next up, you need to get Application 2 running and proceed with the Angular 8 upgrade:

<strong>$ n 8.16.0</strong>
...
<strong>$ cd application2</strong>
<strong>~/application2$ npm install</strong>
...
<strong>~/application2$ npm start</strong>
...
<strong>~/application2$ n 10.16.0</strong>
...
<strong>~/application2$ npm i -g @angular/cli@8</strong>
...
<strong>~/application2$ ng update @angular/cli @angular/core</strong>
...
<strong>~/application2$ npm install</strong>
...
<strong>~/application2$ npm start</strong>
...

Node v8.16.0 was installed to make sure Application 2 is working prior to the upgrade. Then, Node v10.16.0 is installed as required by Angular 8. The Angular CLI is installed globally, and the application is updated with ng update . Finally, the application is started to test after the upgrade.

You might have noticed that n makes it slightly quicker to install and switch to new versions of Node with a single n <version> command.

Using a Node binary directly

n offers the ability to invoke a specific Node binary directly without having to explicitly switch to that Node version. NVM does not have a similar capability.

<strong>~$ echo "console.log('Node version: ' + process.version)" > index.js</strong>
<strong>~$ node -v</strong>
v8.16.0
<strong>~$ n use 10.16.0 index.js</strong>
Node version: v10.16.0
<strong>~$ n use 12.4.0 index.js</strong>
  Error: '12.4.0' is not installed
<strong>~$ node -v</strong>
v8.16.0

In the example above, the active version of Node is v8.16.0. When n use 10.16.0 index.js is run, the output indicates that the version of Node used to execute the script was 10.16.0. After execution, the active version of Node is still v8.16.0. Note that the n use command requires the requested version of Node to be installed by n already.

This capability can be useful in certain situations. For example, think of a build server used to build different apps with their own required Node versions. Each build could be triggered with the n use command, specifying the required Node version for that application.

Summary comparison

NVM for Windows and n have many common features and some unique features that affect how and where you use each tool. Here is a summary of some of the key differences: