From 5332082d009914a8eeb087cc5057c0cc11f3207e Mon Sep 17 00:00:00 2001 From: will Date: Mon, 19 May 2025 10:28:51 +0100 Subject: [PATCH] doc: add alpine build instructions --- doc/build-unix.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/doc/build-unix.md b/doc/build-unix.md index d8857d43a7..8ffa4edfa6 100644 --- a/doc/build-unix.md +++ b/doc/build-unix.md @@ -139,6 +139,46 @@ The GUI will be able to encode addresses in QR codes unless this feature is expl 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. +### Alpine + +#### Dependency Build Instructions + +Build requirements: + + apk add build-base cmake linux-headers pkgconf python3 + +Now, you can either build from self-compiled [depends](#dependencies) or install the required dependencies: + + apk add libevent-dev boost-dev + +SQLite is required for the descriptor wallet: + + apk add sqlite-dev + +To build Bitcoin Core without wallet, see [*Disable-wallet mode*](#disable-wallet-mode) + +ZMQ dependencies (provides ZMQ API): + + apk add zeromq-dev + +User-Space, Statically Defined Tracing (USDT) is not directly compatible on +Alpine as it uses libc functionality not available on musl. + +GUI dependencies: + +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. + + apk add qt6-qtbase-dev qt6-qttools-dev + +For Qt 6.5 and later, the `xcb-util-cursor` package must be installed at runtime. + +The GUI will be able to encode addresses in QR codes unless this feature is explicitly disabled. To install libqrencode, run: + + apk add libqrencode-dev + +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. + ## Dependencies See [dependencies.md](dependencies.md) for a complete overview, and