Supported Node Versions

Self-Hosted / Supported Node Versions

Latest Ghost 1.X currently supports Node versions 8.9+ and 6.9+ only.

Ghost is following Node's LTS plan, only supporting LTS versions of Node (read why).

The recommended version of Node to use with Ghost is currently Node v8 LTS.

Version
Support Level

<6.9

Unsupported

>=6.9 <7.* (Node v6 boron LTS)

Supported

7.*

Unsupported

>=8.0 <8.9

Unsupported

>=8.9 (Node v8 carbon LTS)

Recommended

9.*

Unsupported

10.*

Unsupported

Note

We don't normally change engines or recommendations based on Node.js security announcements. But Node.js updated all versions in July 2017 because of a high severity vulnerability. So you might want to bump your version.

Support Levels

  • Recommended: this is the version of Node that we use with Ghost in production on Ghost(Pro) - meaning it is the most heavily tested and issues are actively fixed by the core team.
  • Supported: these versions of Node are known to work with Ghost. There is a Travis build for these versions meaning they are checked against our test suite and we will always try to resolve any issues promptly.
  • Unsupported: there is no build, no testing and no guarantee that Ghost will install or run. We will not prioritise fixing issues with these versions, but any patches for future versions are very welcome.

If you attempt to install Ghost with an unsupported version of Node.js, you may encounter the error ERROR: Unsupported version of Node and/or Exit status 231. To resolve this, you must install a compatible version of Node.js.

Compatible versions of Node.js can be downloaded from the Node.js releases page. It is also possible to install multiple node versions using nave or nvm.

Support for future versions of Node

As Ghost will be following & supporting Node's LTS versions, this means that Ghost will not be officially supporting the Node 5.x line.

Dropping support for older versions of node.

Following Node's LTS timelines means that support for 0.10.x was dropped completely on 1st November 2016, support for 0.12.x was dropped on 31st December 2016 and support for the v6 LTS was added. Node v4 was dropped on the 30th of April 2018.

Why follow LTS?

Following LTS means two things: 1) no support for the latest node version, e.g. v5.0 and 2) not being able to use the latest and greatest ES2016 features - so why are we doing it?

Node has picked up the pace on their development and so have npm. Between these two things, the surface area for issues whilst installing or upgrading Ghost has grown significantly. All the time spent supporting people trying to upgrade/install on various platforms detracts from the time we have available to build new features.

Equally, spending time tracking changes in node, and testing out each change doesn't impact us or our extensive dependency tree is all time we can't spend on building new features. Further still, dropping support for older node versions and using ES2016, or even adding babel, would significantly increase the amount of support we'd need to do to help our self-install users get and keep Ghost running. We try to encourage the community to support each other, but more often than not it falls to us to ensure our users have a good experience.

Ghost is a tiny project in terms of the number of people actively working on it. We have ambitious plans for what we're trying to do and we need to focus on delivering a useful product. By following LTS we can focus our efforts on meaningful work and keep our time spent on node versioning to a minimum. It also allows us to delay the support impact until later and give us a chance to grow our team to cope with the support in the meantime.

If you want to run Ghost on the latest version of node you can, however we are unable to offer support for any issues.

Supported Node Versions

Self-Hosted / Supported Node Versions