NodeSource Binary Distributions

NodeSource provides binary distributions for Debian and Ubuntu-based systems.

Available Architectures

• amd64 (64-bit)
• armhf (ARM 32-bit hard-float, ARMv7 and up)
• arm64 (ARM 64-bit, ARMv8 and up)

Supported Distributions

NodeSource supports various distributions including Ubuntu, Debian, Linux Mint, Devuan, elementary OS, Trisquel, BOSS, BunsenLabs, MX Linux, Sparky Linux, PureOS, Astra Linux CE, Ubilinux, Parrot OS, and Deepin Linux.

Note: Some older versions may have broken build systems for Node.js 18+.

The setup scripts follow a standard lifecycle to prepare an RPM-based system for Node.js installation:

1. Distribution Check: Verifies the system is an RPM-based Linux distribution.
2. Repository Configuration: Configures the NodeSource Node.js RPM repository for the version specified by NODE_VERSION.
3. Package Manager Detection: Identifies whether dnf, yum, or microdnf is available on the system.
4. System Update: Uses the detected package manager to update the system.
5. Post-setup Instruction: Logs a message instructing the user to manually run the installation command (e.g., dnf install nodejs -y) to complete the process.

The setup scripts follow a three-step process to prepare a Debian-based system for Node.js installation:

1. System Check: Verifies that the host is a Debian-based Linux distribution.
2. Repository Configuration: Configures the NodeSource Node.js DEB repository for the version specified in the script.
3. Installation Prompt: Logs a confirmation that the repository is updated and instructs the user to manually run apt install nodejs -y to finish the installation.

Special scripts include:

• setup_current: Installs the current version (e.g., 20.x).
• setup_latest: Installs the latest version (e.g., 21.x).

NodeSource has updated its distribution model with the following changes:

• Package Changes: DEB and RPM packages are now available under the nodistro codename. Instead of version-coupled installers, you can now install Node.js on almost any distribution that meets minimum requirements.
• Installation Scripts: Updated installation scripts are available to facilitate setup.
• RPM Package Signing: RPM packages are now signed using SHA256 for improved security and community support.

NodeSource provides support exclusively for active Node.js versions. As of the current documentation, supported versions are:

• 18
• 20
• 21

Note on Deprecation: Installation scripts for outdated Node.js versions are deprecated. While packages for older versions may still exist in the repository, they are no longer actively supported. It is highly recommended to upgrade to an active version for continued support and security updates.

To install Node.js v20.x or N|Solid, download the setup script and then choose your desired package.

Using sudo/root privileges

sudo yum install -y curl
curl -fsSL https://rpm.nodesource.com/setup_20.x -o nodesource_setup.sh
bash nodesource_setup.sh

# To install N|Solid:
sudo yum install -y nsolid
nsolid -v

# To install Node.js:
sudo yum install -y nodejs
node -v

Without root privileges

yum install -y curl
curl -fsSL https://rpm.nodesource.com/setup_20.x -o nodesource_setup.sh
bash nodesource_setup.sh

# To install N|Solid:
sudo yum install -y nsolid
nsolid -v

# To install Node.js:
yum install -y nodejs
node -v

Each setup script defines its target version using the NODE_VERSION variable. To change the version a script installs, locate the line NODE_VERSION="XX.x" and replace the value with your desired version (e.g., "20.x").

NODE_VERSION="20.x"

If you are attempting to create a mirror of the NodeSource repository and encounter issues such as missing folder listings at URLs like https://deb.nodesource.com/node_XX.x/pool/main/n/ or https://rpm.nodesource.com/pub_20.x/, follow the specialized mirroring guide.

Detailed instructions can be found in the Creating a Repository Mirror: A Step-by-Step Guide.

To completely remove Node.js installed via the NodeSource RPM package methods, run the following commands as root or using sudo to remove the package, delete the repository configuration files, and clean the package manager cache.

sudo yum remove nodejs && \
rm -r /etc/yum.repos.d/nodesource*.repo && \
yum clean all

To install Node.js 23.x, first ensure curl is installed. Then download and run the NodeSource setup script, followed by the package installation.

Ubuntu

sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_23.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt install -y nodejs
node -v

Debian (as root)

apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_23.x -o nodesource_setup.sh
bash nodesource_setup.sh
apt install -y nodejs
node -v