Skip to content

Build Libbitcoin Node from source

Instructions how to run a Libbitcoin node

Warning

Running a Libbitcoin node by using bn should only be used by developers/for testing purposes. A Libbitcoin Server should be run for production, it contains the Bitcoin node and address indexing and a client-server interface._

This guide is for people who want to test Libbitcoin v4

macOS

Using install.sh

The easiest way to run a libbitcoin node is by cloning the libbitcoin-node repository and then run the install script.

Clone the libbitcoin-node repository:

git clone https://github.com/libbitcoin/libbitcoin-node.git

Get the build requirements:

brew install autoconf automake libtool icu4c

In the libbitcoin-node root directory, execute the install script:

./install.sh --build-dir=/Users/runner/work/libbitcoin-node/ --enable-isystem --prefix=/Users/runner/work/libbitcoin-node/prefix --disable-static --enable-ndebug --build-boost --build-secp256k1

It will show the libbitcoin-node installer configuration and download and install the dependencies in the specified --build-dir. The --prefix is where the bin, etc, include and lib and share directories will be located.

bin contains the bn executable, etc contains the bn.cfg file, which is an example config file (changing values here will not take effect).

Now run the bn executable and the node will start and create outbound connections.