How To Install Nvm Linux – Version Manager Setup Guide

by

Node version management simplifies development workflows across different projects. If you are wondering how to install nvm linux, you have come to the right place. NVM (Node Version Manager) allows you to switch between Node.js versions seamlessly, making it a must-have tool for any developer working on multiple applications.

In this guide, I will walk you through the entire process step by step. We will cover installation, configuration, and common troubleshooting tips. By the end, you will be able to manage Node versions like a pro.

What Is Nvm And Why You Need It

NVM stands for Node Version Manager. It is a command-line tool that lets you install, uninstall, and switch between different versions of Node.js on your Linux system. Without NVM, you would have to manually download and install each Node version, which is time-consuming and error-prone.

Using NVM, you can test your code across multiple Node versions quickly. It also helps avoid conflicts between projects that require different Node versions. For example, one project might need Node 14 while another needs Node 18. NVM makes this easy.

Prerequisites For Installing Nvm On Linux

Before you begin, ensure your Linux system meets these requirements:

  • A Linux distribution (Ubuntu, Debian, CentOS, Fedora, or similar)
  • Internet connection for downloading packages
  • Basic familiarity with the terminal
  • Git installed (optional but recommended)
  • curl or wget installed (most systems have one)

You can check if curl is installed by typing curl --version in your terminal. If not, install it using your package manager. For Ubuntu or Debian, run sudo apt install curl. For CentOS or Fedora, use sudo dnf install curl.

How To Install Nvm Linux

Now let us get into the actual installation. The process is straightforward and involves running a single script from the official NVM repository. Follow these steps carefully.

Step 1: Download The Nvm Installation Script

Open your terminal. The easiest way to install NVM is using the install script from the official GitHub repository. Run one of the following commands:

  1. Using curl: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  2. Using wget: wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

The script will clone the NVM repository to your home directory under ~/.nvm. It will also add the necessary lines to your shell configuration file (like .bashrc, .zshrc, or .profile).

Step 2: Verify The Installation

After the script finishes, you need to reload your shell configuration. You can do this by either closing and reopening your terminal or running:

source ~/.bashrc (if using Bash) or source ~/.zshrc (if using Zsh)

Now check if NVM is installed correctly by typing:

nvm --version

If you see a version number like 0.39.7, the installation was successful. If you get a “command not found” error, do not worry. We will troubleshoot that later.

Step 3: Install Node.js Using Nvm

With NVM installed, you can now install any Node.js version. To install the latest LTS (Long Term Support) version, run:

nvm install --lts

To install a specific version, such as Node 18, use:

nvm install 18

You can list all available versions with nvm ls-remote. This command shows a long list, so you might want to pipe it through less or grep to find what you need.

Step 4: Switch Between Node Versions

Once you have multiple versions installed, you can switch between them easily. Use the following commands:

  • nvm use 18 – switches to Node 18
  • nvm use 14 – switches to Node 14
  • nvm use default – switches to the default version

To set a default version that loads automatically when you open a new terminal, run:

nvm alias default 18

This sets Node 18 as your default. You can change it anytime.

Common Installation Issues And Fixes

Sometimes things do not go as planned. Here are some common problems you might face when learning how to install nvm linux, along with their solutions.

Nvm Command Not Found After Installation

This is the most frequent issue. It usually happens because your shell configuration file was not updated correctly. Check if the following lines are present in your ~/.bashrc, ~/.zshrc, or ~/.profile:

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

If they are missing, add them manually. Then run source ~/.bashrc again.

Permission Denied Errors

If you see permission errors during installation, you might be running the script without proper access. The install script does not require sudo, but if you get errors, check your home directory permissions. You can also try reinstalling with:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Do not use sudo with the install script, as it can cause ownership issues.

Nvm Slow Or Unresponsive

Sometimes NVM can be slow when listing remote versions. This is usually due to network issues or a large number of versions. You can speed things up by using the --no-verify flag or by setting a shorter timeout. Alternatively, use nvm ls-remote --lts to only list LTS versions.

Advanced Nvm Usage Tips

Once you have mastered the basics of how to install nvm linux, you can explore advanced features. These will make your workflow even smoother.

Using Nvm With Project-Specific Node Versions

You can create a .nvmrc file in your project root directory. This file contains the Node version your project requires. For example, create a file with:

echo "18" > .nvmrc

Then, when you enter the project directory, run nvm use. NVM will automatically read the .nvmrc file and switch to the correct version. You can even automate this by adding a script to your shell configuration.

Uninstalling Node Versions

To remove a Node version you no longer need, use:

nvm uninstall 14

This frees up disk space and keeps your environment clean. You can list installed versions with nvm ls.

Installing Nvm On Different Linux Distributions

The installation process is the same for most Linux distributions. However, some systems may have different default shells. For example, if you use Fish shell, you need to install NVM with Fish support. The official NVM repository provides instructions for Fish and other shells.

For Ubuntu, Debian, and their derivatives, the standard method works perfectly. For Arch Linux, you can also install NVM from the AUR using yay -S nvm. For Fedora and CentOS, the script method is recommended.

Frequently Asked Questions

What Is The Difference Between NVM And NPM?

NVM manages Node.js versions, while NPM (Node Package Manager) manages packages for a specific Node version. They work together but serve different purposes. You need NVM to install Node, and then NPM comes with it.

Can I Use NVM With Other Tools Like Yarn?

Yes, absolutely. NVM only manages Node versions. Tools like Yarn, PNPM, or NPM work independently. Just install them after setting your desired Node version with NVM.

Do I Need To Uninstall Existing Node Before Using NVM?

No, you do not have to. NVM can coexist with a system-installed Node. However, to avoid confusion, it is better to uninstall the system Node and rely solely on NVM. Use sudo apt remove nodejs (or your package manager) to remove it.

How Do I Update NVM Itself?

To update NVM to the latest version, run the same install script again. It will overwrite the existing installation. You can also use nvm upgrade if you have an older version that supports it.

Is NVM Safe To Use On Production Servers?

NVM is safe for development environments. For production servers, it is recommended to use a single Node version installed via your package manager or a containerized setup. NVM adds an extra layer that may not be needed in production.

Conclusion

Learning how to install nvm linux is a valuable skill for any Node.js developer. It gives you the flexibility to work on multiple projects without version conflicts. The installation process is simple, and once set up, managing Node versions becomes second nature.

I hope this guide helped you get NVM running on your Linux machine. If you run into any issues, refer to the troubleshooting section or check the official NVM documentation. Happy coding!

Remember to always keep your NVM and Node versions updated. This ensures you have the latest features and security patches. With NVM, you can test your code against different Node versions quickly, making your development workflow more efficient.

Now go ahead and install NVM on your system. You will wonder how you ever managed without it.