Need help upgrading to Ionic Framework 4.0? Get assistance with our Enterprise Migration Services EXPLORE NOW

Using NVM

Improve this doc

nvm is a Node Version Manager that allows you to manage multiple active node.js installations with different versions.

General Usage

With nvm you can install several node versions at the same time and switch between them as you wish. Global packages are installed per node, so you can e.g. have different Ionic CLI versions installed for different node versions.

macOS and Linux


To install or update nvm, you can use the install script using cURL:

curl -o- | bash

or Wget:

wget -qO- | bash

The script clones the nvm repository to ~/.nvm and adds the source line to your profile (~/.bash_profile, ~/.zshrc, ~/.profile, or ~/.bashrc).

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/" ] && . "$NVM_DIR/" # This loads nvm

You can customize the install source, directory, profile, and version using the NVM_SOURCE, NVM_DIR, PROFILE, and NODE_VERSION variables. Eg: curl ... | NVM_DIR=/usr/local/nvm bash for a global install.

NB. The installer can use git, curl, or wget to download nvm, whatever is available.

Note: On OS X, if you get nvm: command not found after running the install script, one of the following might be the reason:-

If the above doesn’t fix the problem, open your .bash_profile and add the following line of code:

source ~/.bashrc

Verify installation

To verify that nvm has been installed, do:

command -v nvm

which should output ‘nvm’ if the installation was successful.


To download, compile, and install the latest release of node, do this:

nvm install node

And then in any new shell just use the installed version:

nvm use node

Or you can just run it:

nvm run node --version

Or, you can run any arbitrary command in a subshell with the desired version of node:

nvm exec 4.2 node --version

You can also get the path to the executable to where it was installed:

nvm which 5.0

In place of a version pointer like “0.10” or “5.0” or “4.2.1”, you can use the following special default aliases with nvm install, nvm use, nvm run, nvm exec, nvm which, etc:



To install NVM on windows, visit the nvm-windows repo and download the latest installer


To list the available and installable node versions:

nvm list available

To install the selected node version call:

nvm install <version>

See how it installed and which node versions can be used:

nvm list

To activate a node installation, do:

nvm use <version>

And if a node version is not required any more, execute:

nvm uninstall <version>