Last updatedDec 21, 2020

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:

1
docker --version

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

Set up Node.js

Forge requires Node.js version 10.0.0 or later.

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

  1. Install nvm.
  2. Select the Node.js v12 Erbium LTS release by running the following in the terminal:

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

    1
    node --version

    Which outputs your node version, for example: v12.19.0.

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:

    1
    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: