How To Install Npm On Linux : Node Package Manager Setup

by

Package management on Linux includes installing Node.js dependencies through npm, and understanding How To Install Npm On Linux is essential for any developer working with JavaScript. Whether you’re setting up a new development environment or managing existing projects, npm (Node Package Manager) helps you install, update, and manage libraries with ease. This guide walks you through the entire process step by step, covering multiple Linux distributions and common troubleshooting scenarios.

Npm is typically bundled with Node.js, so the most common approach is to install Node.js first. However, you can also install npm separately if needed. Let’s explore both methods to ensure you have a working setup regardless of your Linux flavor.

Prerequisites For Installing Npm On Linux

Before you begin, make sure your system meets these basic requirements:

  • A Linux distribution (Ubuntu, Debian, Fedora, CentOS, or Arch Linux)
  • Sudo or root access to install packages
  • An active internet connection
  • Basic familiarity with the terminal

You don’t need any prior Node.js experience to follow this guide. The commands are straightforward and work on most modern Linux systems.

How To Install Npm On Linux

There are several ways to install npm on Linux. The method you choose depends on your distribution and personal preference. Below are the most reliable approaches.

Method 1: Install Node.js And Npm Using Package Manager

This is the simplest method for most users. Your distribution’s official repositories contain Node.js packages that include npm.

For Ubuntu And Debian-Based Systems

  1. Update your package list:
    sudo apt update
  2. Install Node.js and npm:
    sudo apt install nodejs npm
  3. Verify the installation:
    node --version
    npm --version

This installs the version available in your distribution’s repositories. For Ubuntu 22.04, this typically gives you Node.js 12.x and npm 8.x. If you need a newer version, consider using NodeSource or nvm.

For Fedora And RHEL-Based Systems

  1. Enable the Node.js module:
    sudo dnf module enable nodejs:18
  2. Install Node.js and npm:
    sudo dnf install nodejs
  3. Verify the installation:
    node --version
    npm --version

Fedora’s modular repositories allow you to choose specific Node.js versions. The command above installs version 18, which is currently the LTS release.

For Arch Linux And Manjaro

  1. Update your system:
    sudo pacman -Syu
  2. Install Node.js and npm:
    sudo pacman -S nodejs npm
  3. Verify the installation:
    node --version
    npm --version

Arch Linux always provides the latest stable versions, so you’ll get the most recent Node.js and npm releases.

Method 2: Install Npm Using NodeSource Repository

NodeSource provides up-to-date Node.js packages for enterprise use. This method gives you more control over the version you install.

  1. Download and run the NodeSource setup script for your desired version:
    curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
  2. Install Node.js and npm:
    sudo apt install nodejs
  3. Verify the installation:
    node --version
    npm --version

Replace “18.x” with “20.x” or “21.x” if you need a different major version. NodeSource supports Ubuntu, Debian, Fedora, and CentOS.

Method 3: Install Npm Using Nvm (Node Version Manager)

Nvm lets you install and manage multiple Node.js versions simultaneously. This is ideal for developers working on different projects with varying requirements.

  1. Install nvm using the install script:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  2. Reload your shell configuration:
    source ~/.bashrc
  3. List available Node.js versions:
    nvm list-remote
  4. Install the latest LTS version:
    nvm install --lts
  5. Verify the installation:
    node --version
    npm --version

Nvm automatically installs the corresponding npm version for each Node.js release. You can switch between versions using nvm use <version>.

Method 4: Install Npm Standalone

If you already have Node.js installed but need to update npm, or if you want npm without Node.js, you can install it standalone.

  1. Download the npm tarball:
    curl -L https://www.npmjs.com/install.sh | sh
  2. Or use the npm upgrade command if you already have an older version:
    sudo npm install -g npm@latest
  3. Verify the installation:
    npm --version

Standalone installation is less common but useful for specific scenarios like updating npm without changing Node.js.

Verifying Your Npm Installation

After installing, run these commands to confirm everything works correctly:

  • node --version – Shows the Node.js version
  • npm --version – Shows the npm version
  • which node – Shows the path to Node.js
  • which npm – Shows the path to npm

If you see version numbers without errors, your installation is successful. You can now start using npm to install packages.

Common Installation Issues And Fixes

Sometimes things don’t go as planned. Here are frequent problems and their solutions.

Permission Errors When Installing Packages

If you see “EACCES: permission denied” errors, it means npm is trying to write to directories owned by root. Fix this by configuring npm to use a different directory:

  1. Create a directory for global packages:
    mkdir ~/.npm-global
  2. Configure npm to use this directory:
    npm config set prefix '~/.npm-global'
  3. Add the directory to your PATH:
    export PATH=~/.npm-global/bin:$PATH
  4. Add the export to your shell configuration file (~/.bashrc or ~/.zshrc)

Outdated Package Manager Repositories

If your distribution’s repositories contain old versions, use NodeSource or nvm instead. The official repositories often lag behind by several months.

Missing Build Tools

Some npm packages require compilation. Install build tools with:
sudo apt install build-essential (Ubuntu/Debian)
sudo dnf groupinstall "Development Tools" (Fedora)

Updating Npm To The Latest Version

Npm releases updates frequently. Keep your installation current with these commands:

  • Check current version: npm --version
  • Update npm globally: sudo npm install -g npm@latest
  • For nvm users: nvm install-latest-npm

Be careful with the sudo command on some systems, as it can cause permission issues. Consider using the prefix method described earlier instead.

Uninstalling Npm From Linux

If you need to remove npm for any reason, follow these steps:

  • For package manager installations: sudo apt remove nodejs npm (Ubuntu) or sudo dnf remove nodejs (Fedora)
  • For nvm installations: nvm uninstall <version>
  • Remove global npm packages: npm uninstall -g <package>

Uninstalling Node.js also removes npm since they are bundled together.

Frequently Asked Questions

What Is The Difference Between Npm And Node.js?

Node.js is the JavaScript runtime that executes code on the server, while npm is the package manager that installs and manages libraries for Node.js projects. They work together but serve different purposes.

Can I Install Npm Without Node.js?

Yes, you can install npm standalone using the install script from npmjs.com. However, npm requires Node.js to function, so you’ll need Node.js installed anyway. The standalone installation is mainly for updating npm.

Why Do I Get “Command Not Found” After Installing Npm?

This usually means the npm binary is not in your PATH. Check your installation path and add it to your shell configuration file. For nvm users, make sure you’ve sourced your shell configuration after installation.

How Do I Install A Specific Version Of Npm?

Use the command sudo npm install -g npm@<version> to install a specific version. For example, sudo npm install -g npm@9.8.1. You can find available versions on the npm releases page.

Is It Safe To Use Sudo With Npm?

Using sudo with npm can cause permission issues and security risks. It’s better to configure npm to use a local directory for global packages as shown in the troubleshooting section above.

Best Practices For Using Npm On Linux

Once you have npm installed, follow these tips for a smoother experience:

  • Always use a package.json file to track dependencies
  • Run npm init to create a new project
  • Use npm install --save to add dependencies to your project
  • Regularly update packages with npm update
  • Audit your dependencies for vulnerabilities with npm audit
  • Use .gitignore to exclude node_modules from version control

These practices help maintain clean, secure, and manageable projects.

Conclusion

Installing npm on Linux is a straightforward process with multiple options to suit different needs. Whether you choose the package manager method, NodeSource repository, or nvm, you’ll have a fully functional npm environment in minutes. Remember to verify your installation and configure permissions to avoid common issues. With npm installed, you can now access thousands of open-source packages to accelerate your development workflow.

If you encounter any problems during installation, refer back to the troubleshooting section or consult the official npm documentation. The Linux community is also incredibly helpful, so don’t hesitate to search for solutions on forums like Stack Overflow. Now you’re ready to start building amazing applications with Node.js and npm on your Linux system.