Skip to content

Commit

Permalink
modernise README
Browse files Browse the repository at this point in the history 
* remove wheezy & trusty
* remove EL 5
* remove Node <=4
  • Loading branch information
@rvagg
rvagg committed Apr 24, 2018
1 parent e12988f commit dd992d0
Showing 1 changed file with 33 additions and 164 deletions.
197 changes: 33 additions & 164 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,17 +1,13 @@
# [NodeSource](https://nodesource.com) Node.js and io.js Binary Distributions
# [NodeSource](https://nodesource.com) Node.js Binary Distributions

[![NodeSource](images/ns-linux-distributions.svg)](https://nodesource.com)

This repository contains the source of the **[NodeSource](https://nodesource.com)** **[Node.js](http://nodejs.org)** and **[io.js](https://iojs.org)** Binary Distributions setup and support scripts.
This repository contains the source of the **[NodeSource](https://nodesource.com)** **[Node.js](http://nodejs.org)** Binary Distributions setup and support scripts.

[![NodeSource](images/nsolid-logo-dark.svg)](https://nodesource.com/products/nsolid)

If you are looking for NodeSource's Enterprise-grade Node.js platform, **[N|Solid](https://nodesource.com/products/nsolid)**, please visit **<https://downloads.nodesource.com/>**

For **Debian / Ubuntu** based distributions, see the **[deb](./deb)** directory for the source of the two setup scripts located at <https://deb.nodesource.com/setup> and <https://deb.nodesource.com/setup_dev>.

For **Enterprise Linux** based distributions (Red Hat® Enterprise Linux® / RHEL, CentOS, CloudLinux, Fedora), see the **[rpm](./rpm)** directory for the source of setup script located at <https://rpm.nodesource.com/setup>.

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.
Expand All @@ -34,37 +30,31 @@ Pull requests are encouraged if you have changes you believe would improve the s

NodeSource will continue to maintain the following architectures and may add additional ones in the future.

* **i386** (32-bit)
* **i386** (32-bit)—**not available for Node.js 10 and later**
* **amd64** (64-bit)
* **armhf** (ARM 32-bit hard-float, ARMv7 and up: _arm-linux-gnueabihf_)
* **arm64** (ARM 64-bit hard-float, ARMv8 and up: _aarch64-linux-gnu_)

*PLEASE NOTE* that `armhf` builds *AND* builds >= v7.x are **NOT** available for Debian Wheezy. For more information read about [Node.JS >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).
* **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)
* **Ubuntu 16.04 LTS** (Xenial Xerus)
* **Ubuntu 16.10** (Yakkety Yak)
* **Ubuntu 17.04** (Zesty Zappus)
* **Ubuntu 17.10** (Artful Aardvark)
* **Ubuntu 18.04 LTS** (Bionic Beaver)

**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.

* **Debian 7** (wheezy) [Node.js > 6.x is not supported on Debian Wheezy]
* **Debian 8 / stable** (jessie)
* **Debian 9** (stretch)
* **Debian 10 / testing** (buster)
* **Debian unstable** (sid)
* **Debian 8 / stable** (Jessie)
* **Debian 9** (Stretch)
* **Debian 10 / testing** (Buster)
* **Debian unstable** (Sid)

**Supported Linux Mint versions:**

* **Linux Mint 13 "Maya"** (via Ubuntu 12.04 LTS)
* **Linux Mint 17 "Qiana"** (via Ubuntu 14.04 LTS)
* **Linux Mint 17.1 "Rebecca"** (via Ubuntu 14.04 LTS)
* **Linux Mint 17.2 "Rafaela"** (via Ubuntu 14.04 LTS)
Expand All @@ -82,45 +72,41 @@ NodeSource will maintain support for stable, testing and unstable releases of De

**Supported elementary OS versions:**

* **elementary OS Luna** (via Ubuntu 12.04 LTS)
* **elementary OS Freya** (via Ubuntu 14.04 LTS)
* **elementary OS Loki** (via Ubuntu 16.04 LTS)
* **elementary OS Juno** (via Ubuntu 18.04 LTS)

**Supported Trisquel versions:**

* **Trisquel 6 "Toutatis"** (via Ubuntu 12.04 LTS)
* **Trisquel 7 "Belenos"** (via Ubuntu 14.04 LTS)
* **Trisquel 8 "Flidas"** (via Ubuntu 16.04 LTS)

**Supported BOSS versions:**

* **BOSS 5.0 "Anokha"** (via Debian 7)

**Supported BunsenLabs versions:**

* **Hydrogen (rc2)** (via Debian 8)
* **Hydrogen** (via Debian 8)
* **Helium** (via Debian 9)

<a name="debinstall"></a>
### Installation instructions

**Node.js v9.x**:

* NOTE: Debian Wheezy packages are NOT available for this release. Please reference [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).
**Node.js v10.x**:

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_9.x | sudo -E bash -
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_9.x | bash -
curl -sL https://deb.nodesource.com/setup_10.x | bash -
apt-get install -y nodejs
```

**Node.js v8.x**:

* NOTE: Debian Wheezy packages are NOT available for this release. Please reference [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
Expand All @@ -133,8 +119,6 @@ apt-get install -y nodejs

**Node.js v6.x**:

* NOTE: If you are using Debian Wheezy, you might want to read about [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
Expand All @@ -145,82 +129,6 @@ curl -sL https://deb.nodesource.com/setup_6.x | bash -
apt-get install -y nodejs
```

**Node.js v4.x**:

* NOTE: If you are using Debian Wheezy, you might want to read about [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs

# Using Debian, as root
curl -sL https://deb.nodesource.com/setup_4.x | bash -
apt-get install -y nodejs
```

**Node.js v0.12**:

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_0.12 | sudo -E bash -
sudo apt-get install -y nodejs

# Using Debian, as root
curl -sL https://deb.nodesource.com/setup_0.12 | bash -
apt-get install -y nodejs
```

**Node.js v0.10**:

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_0.10 | sudo -E bash -
sudo apt-get install -y nodejs

# Using Debian, as root
curl -sL https://deb.nodesource.com/setup_0.10 | bash -
apt-get install -y nodejs
```

**io.js v3.x**:

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_iojs_3.x | sudo -E bash -
sudo apt-get install -y iojs

# Using Debian, as root
curl -sL https://deb.nodesource.com/setup_iojs_3.x | bash -
apt-get install -y iojs
```

**io.js v2.x**:

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_iojs_2.x | sudo -E bash -
sudo apt-get install -y iojs

# Using Debian, as root
curl -sL https://deb.nodesource.com/setup_iojs_2.x | bash -
apt-get install -y iojs
```

**io.js v1.x**:

_Note: this branch of io.js is not actively maintained and is not recommended for production use._

```sh
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_iojs_1.x | sudo -E bash -
sudo apt-get install -y iojs

# Using Debian, as root
curl -sL https://deb.nodesource.com/setup_iojs_1.x | bash -
apt-get install -y iojs
```

***Optional***: install build tools

To compile and install native addons from npm you may also need to install build tools:
Expand All @@ -243,7 +151,7 @@ This step is only required if you previously used Chris Lea's Node.js PPA.

```sh
# add-apt-repository may not be present on some Ubuntu releases:
#sudo apt-get install python-software-properties
# 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
Expand All @@ -252,20 +160,19 @@ sudo rm -f /etc/apt/sources.list.d/chris-lea-node_js-*.list.save
**2. Add the NodeSource package signing key**

```sh
curl --silent https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo apt-key add -
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 -
```

**3. Add the desired NodeSource repository**


```sh
# Replace with the branch of Node.js or io.js you want to install: node_0.10, node_0.12, node_4.x, node_5.x, etc...
VERSION=node_6.x
# 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: wheezey, jessie, sid, etc...
# - For Ubuntu distributions: trusty, xenial, etc...
# - 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
Expand All @@ -286,90 +193,54 @@ sudo apt-get install nodejs

NodeSource will continue to maintain the following architectures and may add additional ones in the future.

* **i386** (32-bit, not available for all distros)
* **i386** (32-bit)—not available for all distros and **not available for Node.js 10 and later**
* **x86_64** (64-bit)

**Supported Red Hat® Enterprise Linux® versions:**

* **RHEL 5** (32-bit and 64-bit) **[For Node < 4.x]**
* **RHEL 6** (64-bit) **[For Node >= 4.x]**
* **RHEL 6** (64-bit)
* **RHEL 7** (64-bit)

**Supported CentOS versions:**

* **CentOS 5** (32-bit and 64-bit) **[For Node < 4.x]**
* **CentOS 6** (64-bit) **[For Node >= 4.x]**
* **CentOS 6** (64-bit)
* **CentOS 7** (64-bit)

**Supported CloudLinux versions:**
* **CloudLinux 6** (32-bit and 64-bit)
* **CloudLinux 6** (32-bit for Node <= 10.x and 64-bit)

**Supported Fedora versions:**

* **Fedora 25 (Twenty Five)** (32-bit and 64-bit) **[For Node >= 4.7.2]**
* **Fedora 26 (Twenty Six)** (32-bit and 64-bit) **[For Node >= 6.11.0]**
* **Fedora 26** (32-bit for Node <= 10.x and 64-bit)
* **Fedora 27** (32-bit for Node <= 10.x and 64-bit)

Equivalent versions of Korora Linux should also be supported.

<a name="rpminstall"></a>
### Installation instructions

Current instructions for installing, as listed on the [Node.js Wiki](https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager):

Note that the Node.js packages for EL 5 (RHEL5 and CentOS 5) depend on the [EPEL](https://fedoraproject.org/wiki/EPEL) repository being available. The setup script will check and provide instructions if it is not installed.
_NOTE: If you are using RHEL 6 or CentOS 6, you might want to read about [running Node.js on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md)._

Run as root on RHEL, CentOS, CloudLinux or Fedora:

**NodeJS 9.x**

* NOTE: If you are using RHEL 6 or CentOS 6, you might want to read about [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).
**NodeJS 10.x**

```text
curl -sL https://rpm.nodesource.com/setup_9.x | bash -
curl -sL https://rpm.nodesource.com/setup_10.x | bash -
```

**NodeJS 8.x**

* NOTE: If you are using RHEL 6 or CentOS 6, you might want to read about [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).

```text
curl -sL https://rpm.nodesource.com/setup_8.x | bash -
```

**NodeJS 6.x**

* NOTE: If you are using RHEL 6 or CentOS 6, you might want to read about [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).

```text
curl -sL https://rpm.nodesource.com/setup_6.x | bash -
```

**NodeJS 4.x**

* NOTE: If you are using RHEL 6 or CentOS 6, you might want to read about [running Node.js >= 4.x on older distros](https://github.com/nodesource/distributions/blob/master/OLDER_DISTROS.md).

```text
curl -sL https://rpm.nodesource.com/setup_4.x | bash -
```

**NodeJS 0.12.x**

```text
curl -sL https://rpm.nodesource.com/setup_0.12 | bash -
```

**NodeJS 0.10.x**

```text
curl -sL https://rpm.nodesource.com/setup | bash -
```

Then install, as root:

```text
yum install -y nodejs
```

***Optional***: install build tools

To compile and install native addons from npm you may also need to install build tools:
Expand All @@ -390,8 +261,6 @@ curl -sL https://deb.nodesource.com/test | bash -
<a name="questions"></a>
# FAQ

---

Q: How do I use this repo when behind a proxy?

A: Please take a look at [issue #9](https://github.com/nodesource/distributions/issues/9)
Expand All @@ -410,9 +279,9 @@ A: You probably need to clear out your package manager's cache. Take a look at [

---

Q: I'm trying to install Node.js on Centos 5 and it is failing, why?
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 tool chain on Centos5, we currently can only support Node.js 0.10 on that release. See [issue #190](https://github.com/nodesource/distributions/issues/190)
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](https://github.com/nodesource/distributions/issues/190)

---

Expand All @@ -424,7 +293,7 @@ A: Node.js 4.x and newer require a 64bit os for rpms. See [issue #268](https://g

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](https://github.com/nodesource/distributions/issues/247)
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](https://github.com/nodesource/distributions/issues/247)

---

Expand Down Expand Up @@ -473,7 +342,7 @@ Contributions are welcomed from anyone wanting to improve this project!
<a name="project-license"></a>
## License

This material is Copyright (c) 2016 NodeSource and licensed under the MIT license. All rights not explicitly granted in the MIT license are reserved. See the included [LICENSE.md](./LICENSE.md) file for more details.
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](./LICENSE.md) file for more details.

------------------------------------------------------------------

Expand Down

0 comments on commit dd992d0

Please sign in to comment.