Last updated Nov 11, 2022

Rate this page:

Install Forge on macOS

In this short guide you'll install and configure the software required to work with the Forge platform on a macOS platform.

Set up Docker

Forge requires Docker version 17.03 or later. To download Docker, visit get Docker.

Once Docker is installed and running, check your Docker version by running the following in the terminal:

docker --version

Which outputs your Docker version, for example: Docker version 19.03.13, build 4484c46d9d.

Set up Node.js

The Forge CLI requires a fully supported LTS release of Node.js installed; namely, versions 14.x, 16.x, or 18.x.

Forge developers on macOS should use Node Version Manager (nvm) to configure the environment.

  1. Install nvm.

  2. Select the latest Node.js LTS release by running the following in the terminal:

    nvm install --lts
    nvm use --lts
  3. Check your Node.js version, run the following in the terminal:

    node --version

Which outputs your node version.

Node.js installer

You can install Node.js using the macOS installer, however this results in permission errors when working with the Forge CLI. If you must use the installer, you'll need to enable unsafe permissions to use the Forge global package when installing Node.js using this method.

  1. Download a suitable installer from Node.js.

  2. Install the package.

  3. Configure npm, permitting unsafe permissions:

    npm config set unsafe-perm true

Next steps

You're ready to continue the Forge getting started guide, next you'll install the Forge CLI.

Rate this page: