While working on multiple projects, some of them may use different node versions.
This can be a real pain point when you accidentally ran npm install or npm update with a different npm version.
To address these issues, we get something unique called nvm. It stands for: Node Version Manager.
And it can be used to switch between different node versions on your local machine quickly.
The easiest way to install NVM is by using Homebrew.
Run the following command:
brew install nvm
Once installed, you must add it to your preferred profile file so we can use it globally.
A profile file can be one of these: (
Once you have identified it, add the following lines.
export NVM_DIR=~/.nvm source $(brew --prefix nvm)/nvm.sh
This will ensure that you can run the nvm commands every time a terminal opens.
We can quickly test if it works by running the following command in a terminal.
This should output the version of nvm you are using.
Installing and using different node versions
The idea behind nvm is that we can install and manage multiple node versions.
The first step is to install the versions we might need.
nvm install 16 nvm install lts nvm install 12.14.3
The above are all accepted node versions you can install.
Once we have them installed, we can use the following command to use them.
nvm use 16 nvm use lts nvm use 12.14.3
.nvmrc file to the root of your project. In there, add the version of the node this project uses.
For instance, a file could have node 12.14.3. We can then add the
.nvmrc file and the following content.
Now when you open the project in your favorite editor, you can run the
nvm use command, and it will install the version defined in the
Bonus tip: A great visual studio code plugin does this every time you open a project!