mirror of https://github.com/bitcoin/bitcoin.git synced 2025-11-15 16:38:23 +01:00

Files

merge-script bf75c9964f Merge bitcoin/bitcoin#32828 : build, docs: Fix Boost-related issues on NetBSD

5a5ddbd789 build: Add workaround for NetBSD bug in `Boost::headers` target (Hennadii Stepanov)
4eb3cee919 doc: Update NetBSD Build Guide (Hennadii Stepanov)

Pull request description:

  The recently merged https://github.com/bitcoin/bitcoin/pull/32667 broke builds on NetBSD due to the following issues:

  1. The `boost-headers` package does not provide CMake configuration files now required since https://github.com/bitcoin/bitcoin/pull/32667.

     The first commit updates the Build Guide to recommend using the `boost` package instead.

  2. The CMake configuration file provided by the `boost` package is [broken](https://github.com/NetBSD/pkgsrc/issues/167).

     The second commit adds a workaround for this issue.

  Upstream issues:
  - https://github.com/NetBSD/pkgsrc/issues/167
  - https://github.com/NetBSD/pkgsrc/issues/168

  Successful CI job: https://github.com/hebasto/bitcoin-core-nightly/actions/runs/15958818914/job/45008576879.

ACKs for top commit:
  purpleKarrot:
    ACK 5a5ddbd789

Tree-SHA512: 617543edf2216c3673195cc562541d7637d7ea199320916c3660a91f6ee1ff01c014f519c5eeb3fc224f7a7304fdb75965ee3f4554d7fb277dd05ba3a6583b45

2025-07-02 13:29:49 +01:00

3.0 KiB

Raw Blame History

NetBSD Build Guide

Updated for NetBSD 10.1

This guide describes how to build bitcoind, command-line utilities, and GUI on NetBSD.

Preparation

1. Install Required Dependencies

Install the required dependencies the usual way you install software on NetBSD. The example commands below use pkgin.

pkgin install git cmake pkg-config boost libevent

NetBSD currently ships with an older version of gcc than is needed to build. You should upgrade your gcc and then pass this new version to the configure script.

For example, grab gcc12:

pkgin install gcc12

Then, when configuring, pass the following:

cmake -B build
    ...
    -DCMAKE_C_COMPILER="/usr/pkg/gcc12/bin/gcc" \
    -DCMAKE_CXX_COMPILER="/usr/pkg/gcc12/bin/g++" \
    ...

See dependencies.md for a complete overview.

2. Clone Bitcoin Repo

Clone the Bitcoin Core repository to a directory. All build scripts and commands will run from this directory.

git clone https://github.com/bitcoin/bitcoin.git

3. Install Optional Dependencies

Wallet Dependencies

It is not necessary to build wallet functionality to run bitcoind or the GUI.

Descriptor Wallet Support

sqlite3 is required to enable support for descriptor wallets.

pkgin install sqlite3

GUI Dependencies

Qt6

Bitcoin Core includes a GUI built with the cross-platform Qt Framework. To compile the GUI, we need to install the necessary parts of Qt, the libqrencode and pass -DBUILD_GUI=ON. Skip if you don't intend to use the GUI.

pkgin install qt6-qtbase qt6-qttools

libqrencode

The GUI will be able to encode addresses in QR codes unless this feature is explicitly disabled. To install libqrencode, run:

pkgin install qrencode

Otherwise, if you don't need QR encoding support, use the -DWITH_QRENCODE=OFF option to disable this feature in order to compile the GUI.

Notifications

ZeroMQ

Bitcoin Core can provide notifications via ZeroMQ. If the package is installed, support will be compiled in.

pkgin zeromq

Test Suite Dependencies

There is an included test suite that is useful for testing code changes when developing. To run the test suite (recommended), you will need to have Python 3 installed:

pkgin install python310 py310-zmq

Building Bitcoin Core

1. Configuration

There are many ways to configure Bitcoin Core. Here is an example that explicitly disables the wallet and GUI:

cmake -B build -DENABLE_WALLET=OFF -DBUILD_GUI=OFF

Run cmake -B build -LH to see the full list of available options.

2. Compile

Build and run the tests:

cmake --build build     # Append "-j N" for N parallel jobs.
ctest --test-dir build  # Append "-j N" for N parallel tests. Some tests are disabled if Python 3 is not available.

3.0 KiB Raw Blame History