distributions/README.md at master · nodesource/distributions · GitHub Skip to content Sign up Why GitHub? Features → Mobile → Actions → Codespaces → Packages → Security → Code review → Project management → Integrations → GitHub Sponsors → Customer stories → Security → Team Enterprise Explore Explore GitHub → Learn & contribute Topics → Collections → Trending → Learning Lab → Open source guides → Connect with others The ReadME Project → Events → Community forum → GitHub Education → GitHub Stars program → Marketplace Pricing Plans → Compare plans → Contact Sales → Nonprofit → Education → In this repository All GitHub ↵ Jump to ↵ No suggested jump to results In this repository All GitHub ↵ Jump to ↵ In this organization All GitHub ↵ Jump to ↵ In this repository All GitHub ↵ Jump to ↵ Sign in Sign up {{ message }} nodesource / distributions Watch 253 Star 8k Fork 1.9k Code Issues 61 Pull requests 3 Actions Projects 0 Wiki Security Insights More Code Issues Pull requests Actions Projects Wiki Security Insights Permalink master distributions/README.md Go to file Go to file T Go to line L Copy path igsu Update README.md Latest commit 84b6168 Jan 25, 2021 History 47 contributors Users who have contributed to this file +29 561 lines (389 sloc) 22.6 KB Raw Blame NodeSource Node.js Binary Distributions This repository contains documentation for using the NodeSource Node.js Binary Distributions via .rpm, .deb and Snap packages as well as their setup and support scripts. If you are looking for NodeSource's low-impact Node.js performance monitoring platform, please get started here. Please file an issue if you are experiencing a problem or would like to discuss something related to the distributions. Pull requests are encouraged if you have changes you believe would improve the setup process or increase compatibility across Linux distributions. Table of Contents Debian and Ubuntu based distributions (deb) Installation instructions Manual installation Enterprise Linux based distributions (rpm) Installation instructions Snap packages About Installation instructions Advanced usage Tests FAQ Requested Distributions License Debian and Ubuntu based distributions Available architectures: NodeSource will continue to maintain the following architectures and may add additional ones in the future. amd64 (64-bit) armhf (ARM 32-bit hard-float, ARMv7 and up: arm-linux-gnueabihf) arm64 (ARM 64-bit, ARMv8 and up: aarch64-linux-gnu) Supported Ubuntu versions: NodeSource will maintain Ubuntu distributions in active support by Canonical, including LTS and the intermediate releases. Ubuntu 14.04 LTS (Trusty Tahr) - not available for Node.js 10 and later Ubuntu 16.04 LTS (Xenial Xerus) Ubuntu 18.04 LTS (Bionic Beaver) Ubuntu 18.10 (Cosmic Cuttlefish) Ubuntu 19.04 (Disco Dingo) Ubuntu 19.10 (Eoan Ermine) Ubuntu 20.04 LTS (Focal Fossa) Ubuntu 20.10 (Groovy Gorilla) Supported Debian versions: NodeSource will maintain support for stable, testing and unstable releases of Debian, due to the long release cycle a considerable number of users are running unstable and testing. Debian 8 / oldoldstable (Jessie) Debian 9 / oldstable (Stretch) Debian 10 / stable (Buster) Debian unstable (Sid) Debian testing (Bullseye) Supported Linux Mint versions: Linux Mint 17 "Qiana" (via Ubuntu 14.04 LTS) - not available for Node.js 10 and later Linux Mint 17.1 "Rebecca" (via Ubuntu 14.04 LTS) - not available for Node.js 10 and later Linux Mint 17.2 "Rafaela" (via Ubuntu 14.04 LTS) - not available for Node.js 10 and later Linux Mint 18 "Sarah" (via Ubuntu 16.04 LTS) Linux Mint 18.1 "Serena" (via Ubuntu 16.04 LTS) Linux Mint 18.2 "Sonya" (via Ubuntu 16.04 LTS) Linux Mint 18.3 "Sylvia" (via Ubuntu 16.04 LTS) Linux Mint Debian Edition (LMDE) 2 "Betsy" (via Debian 8) Linux Mint 19 "Tara" (via Ubuntu 18.04 LTS) Linux Mint 19.1 "Tessa" (via Ubuntu 18.04 LTS) Linux Mint 19.2 "Tina" (via Ubuntu 18.04 LTS) Linux Mint 19.3 "Tricia" (via Ubuntu 18.04 LTS) Linux Mint 20 "Ulyana" (via Ubuntu 20.04 LTS) Linux Mint 20.1 "Ulyssa" (via Ubuntu 20.04 LTS) Linux Mint Debian Edition (LMDE) 3 "Cindy" (via Debian 9) Linux Mint Debian Edition (LMDE) 4 "Debbie" (via Debian 10) Supported Devuan versions: Jessie / oldstable (via Debian 8) Ascii / stable (via Debian 9) Beowulf / testing (via Debian 10) Ceres / unstable (via Debian unstable) Supported elementary OS versions: elementary OS 0.3 Freya (via Ubuntu 14.04 LTS) - not available for Node.js 10 and later elementary OS 0.4 Loki (via Ubuntu 16.04 LTS) elementary OS 5 Juno (via Ubuntu 18.04 LTS) elementary OS 5.1 Hera (via Ubuntu 18.04 LTS) elementary OS 6 Odin (via Ubuntu 20.04 LTS) Supported Trisquel versions: Trisquel 7 "Belenos" (via Ubuntu 14.04 LTS) - not available for Node.js 10 and later Trisquel 8 "Flidas" (via Ubuntu 16.04 LTS) Trisquel 9 "Etiona" (via Ubuntu 18.04 LTS) Supported BOSS versions: BOSS 5.0 "Anokha" (via Debian 7) - not available for Node.js 10 and later BOSS 6.0 "Anoop" (via Debian 8) BOSS 7.0 "Drishti" (via Debian 9) BOSS 8.0 "Unnati" (via Debian 10) Supported BunsenLabs versions: Hydrogen (via Debian 8) Helium (via Debian 9) Lithium (via Debian 10) Supported MX Linux versions: MX-17 Horizon (via Debian 9) MX-18 Continuum (via Debian 9) MX-19 Patito Feo (via Debian 10) Supported Sparky Linux versions: Sparky 4.x "Tyche" (via Debian 9) Sparky 5.x "Nibiru" (via Debian 10) Supported PureOS Linux versions: PureOS 9.0 "Amber" (via Debian 10) Supported Astra Linux CE versions: Astra Linux CE 2.12 "Orel" (via Debian 9) Supported Ubilinux versions: Ubilinux 4.0 "Dolcetto" (via Debian 9) Installation instructions Node.js v15.x: # Using Ubuntu curl -sL https://deb.nodesource.com/setup_15.x | sudo -E bash - sudo apt-get install -y nodejs # Using Debian, as root curl -sL https://deb.nodesource.com/setup_15.x | bash - apt-get install -y nodejs Node.js v14.x: # Using Ubuntu curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - sudo apt-get install -y nodejs # Using Debian, as root curl -sL https://deb.nodesource.com/setup_14.x | bash - apt-get install -y nodejs Node.js v12.x: # Using Ubuntu curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash - sudo apt-get install -y nodejs # Using Debian, as root curl -sL https://deb.nodesource.com/setup_12.x | bash - apt-get install -y nodejs Node.js v10.x: # Using Ubuntu curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash - sudo apt-get install -y nodejs # Using Debian, as root curl -sL https://deb.nodesource.com/setup_10.x | bash - apt-get install -y nodejs Node.js LTS (v14.x): # Using Ubuntu curl -sL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs # Using Debian, as root curl -sL https://deb.nodesource.com/setup_lts.x | bash - apt-get install -y nodejs Node.js Current (v15.x): # Using Ubuntu curl -sL https://deb.nodesource.com/setup_current.x | sudo -E bash - sudo apt-get install -y nodejs # Using Debian, as root curl -sL https://deb.nodesource.com/setup_current.x | bash - apt-get install -y nodejs Optional: install build tools To compile and install native addons from npm you may also need to install build tools: # use `sudo` on Ubuntu or run this as root on debian apt-get install -y build-essential Manual installation If you're not a fan of curl | bash -, or are using an unsupported distribution, you can try a manual installation. These instructions assume sudo is present, however some distributions do not include this command by default, particularly those focused on a minimal environment. In this case, you should install sudo or su to root to run the commands directly. 1. Remove the old PPA if it exists This step is only required if you previously used Chris Lea's Node.js PPA. # add-apt-repository may not be present on some Ubuntu releases: # sudo apt-get install python-software-properties sudo add-apt-repository -y -r ppa:chris-lea/node.js sudo rm -f /etc/apt/sources.list.d/chris-lea-node_js-*.list sudo rm -f /etc/apt/sources.list.d/chris-lea-node_js-*.list.save 2. Add the NodeSource package signing key curl -sSL https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo apt-key add - # wget can also be used: # wget --quiet -O - https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo apt-key add - The key ID is 1655A0AB68576280. 3. Add the desired NodeSource repository # Replace with the branch of Node.js or io.js you want to install: node_6.x, node_8.x, etc... VERSION=node_8.x # The below command will set this correctly, but if lsb_release isn't available, you can set it manually: # - For Debian distributions: jessie, sid, etc... # - For Ubuntu distributions: xenial, bionic, etc... # - For Debian or Ubuntu derived distributions your best option is to use the codename corresponding to the upstream release your distribution is based off. This is an advanced scenario and unsupported if your distribution is not listed as supported per earlier in this README. DISTRO="$(lsb_release -s -c)" echo "deb https://deb.nodesource.com/$VERSION $DISTRO main" | sudo tee /etc/apt/sources.list.d/nodesource.list echo "deb-src https://deb.nodesource.com/$VERSION $DISTRO main" | sudo tee -a /etc/apt/sources.list.d/nodesource.list 4. Update package lists and install Node.js sudo apt-get update sudo apt-get install nodejs Enterprise Linux based distributions Available architectures: NodeSource will continue to maintain the following architectures and may add additional ones in the future. i386 (32-bit) — not available for all distros and not available for Node.js 10.x and later x86_64 (64-bit) arm64 (ARM 64-bit, ARMv8 and up: aarch64-linux-gnu) Supported Red Hat® Enterprise Linux® versions: RHEL 7 (64-bit) RHEL 8 (64-bit) Supported CentOS versions: CentOS 7 (64-bit) CentOS 8 (64-bit) CentOS 8 Stream (64-bit) Supported CloudLinux versions: CloudLinux 6 (32-bit for Node <= 10.x and 64-bit) Supported Fedora versions: Fedora 31 (64-bit) - available for Node.js 10.17.0 and later Fedora 32 (64-bit) Fedora 33 (64-bit) Supported Amazon Linux versions: Amazon Linux (64-bit) Amazon Linux 2 (64-bit) Installation instructions NOTE: If you are using RHEL 6 or CentOS 6, you might want to read about running Node.js on older distros. The Nodesource RPM package signing key is available here: https://rpm.nodesource.com/pub/el/NODESOURCE-GPG-SIGNING-KEY-EL Run on RHEL, CentOS, CloudLinux, Amazon Linux or Fedora: Node.js v15.x # As root curl -sL https://rpm.nodesource.com/setup_15.x | bash - # No root privileges curl -sL https://rpm.nodesource.com/setup_15.x | sudo bash - Node.js v14.x # As root curl -sL https://rpm.nodesource.com/setup_14.x | bash - # No root privileges curl -sL https://rpm.nodesource.com/setup_14.x | sudo bash - Node.js v12.x # As root curl -sL https://rpm.nodesource.com/setup_12.x | bash - # No root privileges curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash - Node.js v10.x # As root curl -sL https://rpm.nodesource.com/setup_10.x | bash - # No root privileges curl -sL https://rpm.nodesource.com/setup_10.x | sudo bash - Node.js LTS (14.x) # As root curl -sL https://rpm.nodesource.com/setup_lts.x | bash - # No root privileges curl -sL https://rpm.nodesource.com/setup_lts.x | sudo bash - Node.js Current (15.x) # As root curl -sL https://rpm.nodesource.com/setup_current.x | bash - # No root privileges curl -sL https://rpm.nodesource.com/setup_current.x | sudo bash - Optional: install build tools To compile and install native addons from npm you may also need to install build tools: yum install gcc-c++ make # or: yum groupinstall 'Development Tools' Snap packages About Snaps are containerized software packages designed to work across cloud, desktop, and IoT devices. They work natively on most popular Linux distributions and feature automatic transactional updates. The NodeSource-managed Node.js snap contains the Node.js runtime, along with the two most widely-used package managers, npm and Yarn. They are delivered from the snapcraft store and are automatically built and pushed for each supported Node.js release line. Generally you will have a new version of Node.js automatically running on your computer the same day it is released on nodejs.org. The Node.js snap can currently be installed on Arch Linux, Debian, Fedora, Linux Mint, Manjaro, OpenEmbedded/Yocto, OpernWrt, Solus, Ubuntu and many other distributions built on top these. NodeSource has not tested the Node.js snap on all of these distributions and feedback is welcome in this repository if you run into problems. Installation instructions The snap command ships with Ubuntu, from version 16.04 and later. If you do not have it installed, follow the instructions on snapcraft to install snapd. Snaps are delivered via "channels"; for Node.js, the channel names are the major-version number of Node.js. So select a supported Node.js version and install with: sudo snap install node --classic --channel=8 Substituting 8 for the major version you want to install. Both LTS and Current versions of Node.js are available via snapcraft. The --classic argument is required here as Node.js needs full access to your system in order to be useful, therefore it needs snap’s "classic confinement". By default, snaps are much more restricted in their ability to access your disk and network and must request special access from you where they need it. Note that on some Linux distributions, the snap confinement mechanisms are not fully supported so --classic may not be necessary or even supported. Once installed, the node, npm and yarn commands are available for use and will remain updated for the channel you selected. Switching channels You can use the refresh command to switch to a new channel at any time: sudo snap refresh node --channel=10 Once switched, snapd will update Node.js for the new channel you have selected. Bleeding-edge Node.js Users feeling adventurous or interested in testing the latest code from the Node.js core developers can install from the "edge" channel. This has an element of risk: it is a direct pipeline from the upstream Node.js git repository to the snap store every day and previews the ongoing development work and may include breaking changes slated for the next major version of Node.js. This is only recommend for those users who are willing to participate in testing and bug reporting upstream: sudo snap install node --classic --channel=edge Not recommended for production deployments Due to their auto-updating nature, snaps are not necessarily appropriate for the deployment of your Node.js applications to production. NodeSource recommends a stable and integration-tested deployment pipeline for production applications such as the .deb or .rpm distributions outlined above. However, snaps are an excellent way to keep developer machines updated and allow for trivial and convenient switching between Node.js versions. Advanced usage The snap man page, or Canonical’s advanced snap usage tutorial contains details of advanced snapd functionality. Tests To test an installation is working (and that the setup scripts are working!) use: curl -sL https://deb.nodesource.com/test | bash - FAQ Q: How do I use this repo when behind a proxy? A: Please take a look at issue #9 Q: How do I pin to specific versions of Node.js? A: Please take a look at issue #33 Q: I upgraded to a new major version of Node.js using the scripts, but the old version is still being installed, what is going on? A: You probably need to clear out your package manager's cache. Take a look at issue #191 Q: I'm trying to install Node.js on CentOS 5 / RHEL 5 and it is failing, why? A: Due to the limitations of the compiler toolchain on EL 5 and its end of general support, we no longer support. See issue #190 Q: I'm seeing "Your distribution, identified as ".i686" or ".i386, is not currently supported, why? A: Node.js 4.x and newer require a 64bit os for rpms. See issue #268 Q: Why have certain versions of platforms/releases stopped receiving updates to Node.js? A: Unfortunately, newer versions of V8 require a modern compiler toolchain. On some platforms, such as ARM wheezy, that toolchain is not available. See issue #247 Q: Why is my Node.js version newer than the one of the script I’ve run? A: Your package manager is probably installing a newer Node.js version from a different source. See issue #657 Q: What is the current status of IPv6 support? A: See issue #170 Requested Distributions We, unfortunately, do not have the resources necessary to support and test the plethora of Linux releases in the wild, so we rely on community members such as yourself to get support on your favorite distributions! This is a list of releases that have been requested by the community. If you are interested in contributing to this project, this would be a great place to start! OpenSUSE - Issue #199 Scientific Linux - Issue #251 LinuxMint Nadia - Issue #269 TANGLU Bartholomea - Issue #81 Korora - Issue #130 FreePBX - Issue #257 Deepin - Issue #638 PopOS - Issue #924 Kylin - Issue #1011 MakuluLinux - Issue #1012 Authors and Contributors Chris Lea GitHub/chrislea Twitter/@chrislea Rod Vagg GitHub/rvagg Twitter/@rvagg William Blankenship GitHub/retrohacker Twitter/@retrohack3r Harry Truong GitHub/harrytruong Matteo Brunati GitHub/mattbrun Brian White GitHub/mscdex Matt Lewandowsky GitHub/lewellyn Jan-Hendrik Peters GitHub/hennr Andris Reinman GitHub/andris9 Carvilsi GitHub/carvilsi Krasimir Trenchev GitHub/Ava7 Phil Helm GitHub/phelma 0xmohit GitHub/0xmohit jdarling GitHub/jdarling Prayag Verma GitHub/pra85 Misha Brukman GitHub/mbrukman Simon Lydell GitHub/lydell Sebastian Blei GitHub/iamsebastian Jorge Maldonado Ventura NotABug/jorgesumle Mayank Metha GitHub/mayankmetha Twitter/@mayankmethad Adrian Estrada GitHub/edsadr Twitter/@edsadr Iván Iguarán GitHub/igsu Contributions are welcomed from anyone wanting to improve this project! License This material is Copyright (c) NodeSource and licensed under the MIT license. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE.md file for more details. Supported with love by the NodeSource team This project is not affiliated with Debian, Ubuntu, Red Hat, CentOS or Fedora. Ubuntu is a registered trademark of Canonical Ltd. Debian is a registered trademark owned by Software in the Public Interest, Inc. Red Hat, CentOS and Fedora are trademarks of Red Hat, Inc. CloudLinux is a trademark of Cloud Linux, Inc Go © 2021 GitHub, Inc. Terms Privacy Security Status Docs Contact GitHub Pricing API Training Blog About You can’t perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.