How To Install Node.js On Ubuntu Without "Unmet Dependencies" Error?

Published September 3, 2024

Problem: Node.js Installation Issues on Ubuntu

Installing Node.js on Ubuntu can sometimes cause an "Unmet Dependencies" error. This error happens when the package manager can't find all the needed dependencies for Node.js installation, which stops the process from finishing.

Preparing Your Ubuntu System for Node.js Installation

Updating and Upgrading Ubuntu Packages

Before installing Node.js, update your Ubuntu system. This refreshes your package lists and upgrades existing packages, which can help avoid conflicts during the Node.js installation.

To update your package lists, open a terminal and run:

sudo apt update

After updating, upgrade your existing packages with:

sudo apt upgrade

These commands make sure your system has the latest information about available packages and that all installed packages are up to date.

Tip: Check for Reboot

After upgrading packages, check if your system needs a reboot. You can use the command:

[ -f /var/run/reboot-required ] && echo 'Reboot required'

If it outputs 'Reboot required', restart your system to apply all updates.

Installing Essential Build Tools

Some Node.js packages require compilation from source code. To make this process easier, you need to install essential build tools. These tools include compilers and other development packages that Node.js and its modules might need.

Install the build essentials package by running:

sudo apt install build-essential

This package includes necessary development tools like gcc, g++, and make.

You might also want to install the curl utility, which is often used to download Node.js-related resources:

sudo apt install curl

By preparing your Ubuntu system with these updates and essential tools, you create a good base for a successful Node.js installation.

Installing Node.js Using the Official PPA

Adding the Node.js PPA Repository

To install Node.js on Ubuntu, use the official Personal Package Archive (PPA) from NodeSource. This PPA gives you the latest version of Node.js.

Add the PPA to your system with this command:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

This command downloads and runs a script that adds the NodeSource PPA to your system. The script also updates your package lists.

Tip: Verify PPA Addition

After running the curl command, you can verify that the PPA was added successfully by checking the contents of the /etc/apt/sources.list.d/ directory:

ls /etc/apt/sources.list.d/

You should see a file named nodesource.list in the output.

Updating Package Lists After Adding PPA

Even though the previous step updates the package lists, it's good to run an update again:

sudo apt update

This command refreshes your package information, including the new Node.js packages from the PPA.

Installing Node.js and NPM

With the PPA added and package lists updated, you can now install Node.js and NPM (Node Package Manager):

sudo apt install nodejs

This command installs both Node.js and NPM. The nodejs package from the NodeSource PPA includes both, so you don't need to install them separately.

After the installation, you'll have the latest LTS (Long Term Support) version of Node.js and NPM on your Ubuntu system.

Verifying the Node.js Installation

After installing Node.js, check if the installation was successful and if all components are working. This verification process helps you confirm that Node.js and NPM are set up on your Ubuntu system.

Checking Node.js Version

To confirm that Node.js was installed, you can check its version. Open a terminal and run this command:

node --version

This command will display the version number of Node.js installed on your system. If you see a version number (for example, v14.17.0), it means Node.js is installed and working.

You can also check the version of NPM by running:

npm --version

This command will show you the version of NPM that was installed with Node.js.

Tip: Verify Node.js and NPM Paths

To make sure Node.js and NPM are correctly added to your system's PATH, you can check their locations using the 'which' command:

which node
which npm

These commands should return the paths where Node.js and NPM are installed, confirming they're accessible from anywhere in your system.

Testing NPM Functionality

To make sure NPM is working, you can try installing a simple package. For example, you can install the "cowsay" package, which is often used for testing:

npm install -g cowsay

The -g flag installs the package globally, making it available system-wide.

After the installation, you can test the package by running:

cowsay "NPM is working!"

If you see a cow saying "NPM is working!" in your terminal, it means NPM is working and can install and run packages.

You can also check if NPM can create a new project. Create a new directory and initialize a Node.js project:

mkdir npm-test
cd npm-test
npm init -y

The -y flag automatically answers "yes" to all the prompts. If this command runs without errors and creates a package.json file in the directory, it confirms that NPM is working as expected.

By doing these checks, you can be sure that Node.js and NPM are installed and ready to use on your Ubuntu system.

Troubleshooting Common Installation Issues

Resolving Package Conflicts

When installing Node.js, you might face package conflicts. Here are steps to fix these issues:

Remove conflicting packages: If you have older versions of Node.js or npm installed, remove them:
```
sudo apt remove nodejs npm
```
Clean the apt cache:
```
sudo apt clean
```
Update package lists:
```
sudo apt update
```
Try installing Node.js again:
```
sudo apt install nodejs
```

If you still face conflicts, check for any held packages:

sudo apt-mark showhold

If any packages are held, unhold them:

sudo apt-mark unhold package_name

Tip: Using PPA for Node.js Installation

If you're still having trouble installing Node.js through the default repositories, consider using a PPA (Personal Package Archive). Here's how:

Add NodeSource PPA:

curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -

Install Node.js:
```
sudo apt-get install -y nodejs
```

This method often bypasses common package conflicts and provides the latest stable version of Node.js.

Clearing Broken Package Dependencies

Broken package dependencies can stop Node.js installation. Here are commands to fix this:

Fix broken dependencies:
```
sudo apt --fix-broken install
```
Remove problem packages:
```
sudo dpkg --remove --force-remove-reinstreq package_name
```
Replace 'package_name' with the name of the problem package.
Clean up partially installed packages:
```
sudo apt clean
sudo apt autoclean
```
Update package lists again:
```
sudo apt update
```
Try a full system upgrade:
```
sudo apt full-upgrade
```

If these steps don't work, you might need to manually download and install the .deb package for Node.js from the official website.

Remember to back up important data before making system-wide changes.

	English
	Deutsch
	Français