Mac Development Requirements

MacOS is not recommended as a production operating system, but it is great for development. For more information on standard HarperDB installation visit the HarperDB Command Line Interface guide. This page details the unique cases you may run into when installing on Mac.


Please note, HarperDB requires a specific version of Node.js as a prerequisite to installation, learn more here.


To install HarperDB please visit the npm install guide:

Possible Errors

An error you may see if Xcode is not already installed is as followed:

gyp: No Xcode or CLT version detected!
gyp ERR! configure error

It may be the case you do have CLT (Command Line Tools). However, the error is asking us to reconfigure, the following commands will help move you forward.


Find the CLT path.

xcode-select --print-path

Remove the directory referenced by the result of the above command:

sudo rm -rf /Library/Developer/CommandLineTools

If you have Git installed, a prompt will appear and you can reinstall the Command Line Tools; follow the prompts.


xcode installer


If Git is NOT installed the following command will create the above mentioned prompt.

xcode-select --install

After installation of the Command Line Tools, the gyp library should no longer throw an error and you can continue.