Mac Development Requirements

MacOS is not recommended as a production operating system, but it is great for development. Developing on a Mac requires a few extra steps to get the latest HarperDB features to build your application on.


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.