Skip to content

Latest commit

 

History

History
116 lines (86 loc) · 3.16 KB

build-osx.md

File metadata and controls

116 lines (86 loc) · 3.16 KB
Raw

macOS 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/Terminal.app

Preparation

Install the macOS command line tools:

xcode-select --install

When the popup appears, click Install.

Then install Homebrew.

Dependencies

brew install automake berkeley-db4 libtool boost miniupnpc pkg-config python qt libevent qrencode

If you run into issues, check Homebrew's troubleshooting page. See dependencies.md 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 4.8. If you have to build it yourself, you can use this script to install it like so:

./contrib/install_db4.sh .

from the root of the repository.

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

Build Namecoin Core

  1. Clone the Namecoin Core source code:

    git clone https://github.com/namecoin/namecoin-core
cd namecoin-core

  2. Build Namecoin Core:

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

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

    ./autogen.sh
./configure
make

  3. It is recommended to build and run the unit tests:

    make check

  4. You can also create a .dmg that contains the .app bundle (optional):

    make deploy

disable-wallet mode

When the intention is to run only a P2P node without a wallet, Bitcoin Core may be compiled in disable-wallet mode with:

./configure --disable-wallet

In this case there is no dependency on Berkeley DB 4.8.

Mining is also possible in disable-wallet mode using the getblocktemplate RPC call.

Running

Namecoin Core is now available at ./src/namecoind

Before running, you may create an empty configuration file:

mkdir -p "/Users/${USER}/Library/Application Support/Bitcoin"

touch "/Users/${USER}/Library/Application Support/Namecoin/namecoin.conf"

chmod 600 "/Users/${USER}/Library/Application Support/Namecoin/namecoin.conf"

The first time you run namecoind, 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/Bitcoin/debug.log

Other commands:

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

Notes

  • Tested on OS X 10.12 Sierra through macOS 10.15 Catalina on 64-bit Intel processors only.
  • Building with downloaded Qt binaries is not officially supported. See the notes in #7714.