This tutorial will teach you how to install the Node.js runtime on the Ubuntu operating system.
This runtime is often used for server-side programming, allowing you to write a scalable and fast web backend in a reasonably well-known language.
- Installing Directly from the Ubuntu package repository
- Easy to install as it only requires a single command.
- However, you will be stuck to the version provided by the Ubuntu package repository.
- Versions provided from old releases of Ubuntu may be no longer supported.
- Installing from the Node.js Package Repository– Recommended
- Requires a few extra steps to add the repository to Ubuntu.
- Allows you to install the latest version.
- Installing Node.js using NVM
- Allows you to install and manage multiple versions of Node.js.
- More complicated than needed if you only want a single release.
Installing Node.js from the Ubuntu Package Repository
For this first method, we will be installing Node.js to Ubuntu straight from the default package repository.
This method means you will be stuck with the version of Node.js provided with your release of Ubuntu. The older release of Ubuntu that you are using, the older version of the runtime will be installed.
For example, Ubuntu 20.04 has the no longer supported 10.19 version of Node.js in it’s repository. But Ubuntu 22.04 contains the newer, but also unsupported, 12.22 release.
If you require a version of Node.js that is kept up to date, please go to “Installing from the Official Node.js Repository on Ubuntu” or “Installing Node.js to Ubuntu using NVM“.
1. We will need to update the package list before we can install Node.JS from the default Ubuntu package repositories.
Updating the package list ensures two things for the system.
- First, the package list cache will be updated, ensuring we are grabbing the latest release.
- Secondly, the cache contains links to where these packages exist. Updating ensures we should only contain live links so “apt” won’t attempt to download NodeJS from an offline mirror.
Update your systems package cache using the following command on your Ubuntu systems terminal.
sudo apt update
2. After the package update completes, we can finally install Node.js to our Ubuntu system.
Run the following command to install the software using the “
apt” package manager.
sudo apt install nodejs
3. You can verify that you have successfully installed Node.js on Ubuntu by querying it for its version.
To get the version of Node.js, you need to use the following command. The “
-v” option tells node to output its version.
Running this on our Ubuntu 22.04 after installing Node.js revealed the following version number
4. Once you have Node.js installed, you may also want to install NPM.
NPM is the package manager for Node.js and is not installed by default when installing Node.js from the Ubuntu package repository.
All you need to do to install NPM is to run the following command on your device.
sudo apt install npm
Once installed, you can install any additional packages and modules you might need for your Node.JS program.
Installing from the Official Node.js Repository on Ubuntu
Using the NodeSource package repository is one of the best ways to install Node.js on Ubuntu. In addition, installing the runtime using this method is the best way to ensure that you are using a currently supported release.
For most people, this would be our recommended way of installing Node.js on Ubuntu.
Preparing for the Node.JS Repository
1. Before proceeding, we should ensure that the package list is up to date by using the following command.
sudo apt update
2. Once the package list has been updated, we can install the packages we need to install Node.js with the below command.
- We install “
curl” to grab the setup scripts from the NodeSource website.
- Additionally, we install the “build-essential” package, including compilation tools that may be used when installing modules for Node.js.
sudo apt install curl build-essential ca-certificates gnupg
3. Before proceeding, make a note of the version that you want to install and run the relevant command. At the time of writing, the latest releases are as follows. You can find the latest version numbers from the
20.x– Current Release.
It comes with the latest features but is potentially more unstable.
18.x– Current LTS Release.
It doesn’t contain the newest features but is actively worked on still.
16.x– Maintenance LTS Release.
No longer actively maintained, the Node team will fix critical bugs as they pop up.
Adding the Node.JS Repository to Ubuntu
4. Once you have decided on what release of Node.js you want to install on Ubuntu, we can move on to setting up the Nodesource repository.
Our first step is to download and add the Nodesource GPG key to our keyring. You can do this by using the following command.
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg
5. With the GPG key added, our next step is to add the Nodesource repository itself to the Ubuntu source list.
To do this all you need to do is use the following command. You can see we reference the “
NODE_MAJOR” environment variable we set earlier on in this section.
echo "deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
6. Before Ubuntu will be aware it can now install Node.JS from Nodesource, we must update the package list.
You can update the package list by using the following command within the terminal.
sudo apt update
7. With the NodeSource package repository added to your device, we can install software from it.
You only need to run the following command to install Node.js on Ubuntu using the new repository. During installation, the “apt” package manager will also install NPM.
sudo apt install nodejs
8. We can verify that we installed the correct version of Node.js by using the command below.
-v” option tells Node.js to output its version to the terminal.
After installing the “current” release of Ubuntu, we got the following version number.
9. Finally, we can verify that NPM was also installed on our Ubuntu device alongside Node.js.
We can achieve this by getting it to report its version number using the following command.
Below is the version that was installed alongside Node.JS on our Ubuntu device.
Installing Node.js to Ubuntu using NVM
The final method for installing Node.js to Ubuntu is to use Node Version Manager, which often goes by the name NVM.
This software is a version manager for Node.js and allows you to have multiples version of Node running at any one time.
In this section, you will learn how to install NVM and use it to install Node.js to your Ubuntu system using it.
1. We must first update our systems package list as there are some packages we must install before proceeding.
Updating the package list is as easy as using the following command.
sudo apt update
2. With the package list updated, we can now install the curl software using the command below.
Curl allows us to make web requests, which in this case will be used to grab and run the NVM install script.
sudo apt install curl
3. Now run the following command to install NVM to your Ubuntu system.
This command will grab the install script and pipe it straight to the shell system.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
4. After NVM is installed, you will need to close and re-open your terminal session before using it.
5. Now that we have NVM installed, we can use it to install Node.js to Ubuntu. This manager allows you to install multiple versions.
You can run the following command if you want to install the current release.
nvm install node
Alternatively, you can install the current LTS release of Node.js on Ubuntu by using the “
nvm install --lts
Finally, you can specify the exact version you want to install. For example, you can use “
17” in place of “
nvm install [VERSION]
6. When you have multiple versions of Node.js installed, you can switch between them by using “
nvm use” followed by the version number.
nvm use [VERSION]
For example, if we wanted to switch from our currently selected version to Node.js 17, we would use the following.
nvm use 17
7. You can list the currently installed versions by using the following command.
8. It is also possible to get NVM to list all of the remote versions of Node.js that you can install on your Ubuntu system.
Throughout this tutorial, we have shown you a couple of ways to install Node.js on Ubuntu-based systems.
Please comment below if you have issues getting this software installed on Ubuntu.
We also have a wealth of other Ubuntu tutorials that you can use to get your system running how you would like it.
Alternatively, we have a wealth of other general Linux tutorials that will help you get familiar with Linux-based systems.