Skip to main content

Node version on macOS images

Historically we have installed the latest version of Node on our Xcode images.

However, as noted by Node:

LTS release status is "long-term support", which typically guarantees that critical bugs will be fixed for a total of 30 months. Production applications should only use Active LTS or Maintenance LTS releases.

With the above in mind, if you encounter any Node-related issues, you may want to reference the Installed software for the Xcode image you are using here

Installing a specific version of Node

As some of the newer images are using non-LTS versions of Node. You may need to manually adjust the node version in your configuration file if you need a specific version. You can install and use a different version of Node with the Node orb. As an example:

version: 2.1orbs:
  node: circleci/[email protected]:
  test-and-build:
    macos:
      xcode: 14.0.0
    steps:
      - node/install:
          node-version: "16.3"
          ...

To adhere to their recommendation though, once the next LTS version is released we plan to pin all newly generated Xcode images to the LTS version.

Did this answer your question?