Merge bitcoin/bitcoin#32559: doc: add alpine build instructions

4f502baf8f doc: add alpine depends build instructions (will)
5332082d00 doc: add alpine build instructions (will)

Pull request description:

  Closes: #32512

  - Provide Alpine build instructions in build-unix.md.
  - Instructions cover building all components except USDT which is marked as unsupported for Alpine.

ACKs for top commit:
  hebasto:
    ACK 4f502baf8f.

Tree-SHA512: 821565714aa556d16c0c721748420333fb5574aa13858186a799a5ccbda981c5b77da2d74a23de01c505591ed3b872eb5552051922ba101fedd50dfddc926b06
This commit is contained in:
merge-script
2025-08-01 14:42:44 +01:00
2 changed files with 51 additions and 0 deletions

View File

@@ -57,6 +57,18 @@ To build dependencies for the current arch+OS:
gmake
### Alpine
apk add bash build-base cmake curl make patch
Skip the following packages if you don't intend to use the GUI and will build with [`NO_QT=1`](#dependency-options):
apk add bison linux-headers samurai pkgconf python3
To build dependencies for the current arch+OS:
make
## Configuring Bitcoin Core
**When configuring Bitcoin Core, CMake by default will ignore the depends output.** In

View File

@@ -143,6 +143,45 @@ 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 supported or tested on Alpine Linux at this time.
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