Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
106 lines (69 sloc) 3.68 KB

Mac OS X Build Instructions and Notes

The commands in this guide should be executed in a Terminal application. The built-in one is located in /Applications/Utilities/


Install the OS X command line tools:

xcode-select --install

When the popup appears, click Install.

Then install Homebrew.


brew install automake libtool boost miniupnpc openssl pkg-config protobuf python3 qt libevent

See for a complete overview.

If you want to build the disk image with make deploy (.dmg / optional), you need RSVG

brew install librsvg

Berkeley DB It is recommended to use Berkeley DB 5.3

brew tap zeroc-ice/tap
brew install zeroc-ice/tap/berkeley-db@5.3

Note: You only need Berkeley DB if the wallet is enabled (see the section Disable-Wallet mode below).

Build Groestlcoin Core

  1. Clone the groestlcoin source code and cd into groestlcoin

     git clone
     cd groestlcoin
  2. Build groestlcoin-core:

    Configure and build the headless groestlcoin binaries as well as the GUI (if Qt is found).

    You can disable the GUI build by passing --without-gui to configure.

    ./configure LDFLAGS=-L/usr/local/opt/berkeley-db@5.3/lib CPPFLAGS=-I/usr/local/opt/berkeley-db@5.3/include
  3. You can also create a .dmg that contains the .app bundle (optional):

    make deploy


Groestlcoin Core is now available at ./src/groestlcoind

Before running, it's recommended you create an RPC configuration file.

echo -e "rpcuser=groestlcoinrpc\nrpcpassword=$(xxd -l 16 -p /dev/urandom)" > "/Users/${USER}/Library/Application Support/Groestlcoin/groestlcoin.conf"

chmod 600 "/Users/${USER}/Library/Application Support/Groestlcoin/groestlcoin.conf"

The first time you run groestlcoind, it will start downloading the blockchain. This process could take several hours.

You can monitor the download process by looking at the debug.log file: tail -f $HOME/Library/Application\ Support/Groestlcoin/debug.log

Once dependencies are compiled, see doc/ for how the bundle is packaged and signed to create the .dmg disk image that is distributed.

Other commands:

./src/groestlcoind -daemon # Starts the groestlcoin daemon.
./src/groestlcoin-cli --help # Outputs a list of command-line options.
./src/groestlcoin-cli help # Outputs a list of RPC commands when the daemon is running.

Using Qt Creator as IDE

You can use Qt Creator as an IDE, for groestlcoin development. Download and install the community edition of Qt Creator. Uncheck everything except Qt Creator during the installation process.

  1. Make sure you installed everything through Homebrew mentioned above
  2. Do a proper ./configure --enable-debug
  3. In Qt Creator do "New Project" -> Import Project -> Import Existing Project
  4. Enter "groestlcoin-qt" as project name, enter src/qt as location
  5. Leave the file selection as it is
  6. Confirm the "summary page"
  7. In the "Projects" tab select "Manage Kits..."
  8. Select the default "Desktop" kit and select "Clang (x86 64bit in /usr/bin)" as compiler
  9. Select LLDB as debugger (you might need to set the path to your installation)
  10. Start debugging with Qt Creator
  • Tested on OS X 10.8 through 10.13 on 64-bit Intel processors only.

  • Building with downloaded Qt binaries is not officially supported. See the notes in #7714