root
147 lines
3.5 KiB
Markdown
147 lines
3.5 KiB
Markdown
Copyright (c) 2026 Agrarian Developers
|
|
|
|
UNIX Build Notes
|
|
|
|
These notes describe how to build Agrarian Core on Unix-based systems.
|
|
For Ubuntu 24.04, prefer the shorter and tested path in
|
|
`doc/build-ubuntu-24.md`.
|
|
|
|
IMPORTANT
|
|
|
|
Always use absolute paths when configuring and compiling Agrarian Core
|
|
and its dependencies.
|
|
|
|
Example:
|
|
|
|
../dist/configure --enable-cxx --disable-shared --with-pic --prefix=$BDB_PREFIX
|
|
|
|
$BDB_PREFIX must be an absolute path. Using $(pwd) ensures an absolute
|
|
path is used.
|
|
|
|
STANDARD BUILD WITH DEPENDS
|
|
|
|
make -C depends HOST=x86_64-pc-linux-gnu NO_QT=0 -j$(nproc)
|
|
./autogen.sh
|
|
CONFIG_SITE=$PWD/depends/x86_64-pc-linux-gnu/share/config.site ./configure
|
|
make -j$(nproc)
|
|
make install (optional)
|
|
|
|
The native depends wallet path currently builds Qt 6.8.3, OpenSSL 3.5.6,
|
|
Boost 1.91.0, protobuf, Berkeley DB, and supporting libraries.
|
|
|
|
For a daemon-only build:
|
|
|
|
JOBS=1 ./contrib/build-linux.sh
|
|
|
|
For a native Ubuntu desktop wallet build:
|
|
|
|
JOBS=1 ./contrib/build-linux-wallet.sh
|
|
|
|
DEPENDENCIES
|
|
|
|
Required: - libssl : Crypto (RNG, ECC) - libboost : Utility (threading,
|
|
data structures) - libevent : Networking (async networking) - libgmp :
|
|
Bignum arithmetic
|
|
|
|
Optional: - miniupnpc : UPnP support - libdb4.8 : Berkeley DB (wallet
|
|
builds only) - qt : GUI support - protobuf : GUI payment protocol -
|
|
libqrencode: QR code support - univalue : JSON parsing (bundled by
|
|
default) - libzmq3 : ZMQ notifications (>= 4.0.0)
|
|
|
|
See dependencies.md for version details.
|
|
|
|
MEMORY REQUIREMENTS
|
|
|
|
Minimum recommended: 1.5 GB RAM.
|
|
|
|
Low memory systems:
|
|
|
|
./configure CXXFLAGS="--param ggc-min-expand=1 --param ggc-min-heapsize=32768"
|
|
|
|
UBUNTU / DEBIAN
|
|
|
|
Build tools:
|
|
|
|
sudo apt-get install build-essential libtool bsdmainutils autotools-dev autoconf pkg-config automake cmake ninja-build python3 curl git
|
|
|
|
System libraries are needed only for non-depends builds. The deterministic
|
|
depends build should be preferred for reproducibility.
|
|
|
|
Libraries for a system-library build:
|
|
|
|
sudo apt-get install libssl-dev libgmp-dev libevent-dev libboost-all-dev
|
|
|
|
Berkeley DB 4.8 (wallet support):
|
|
|
|
sudo apt-get install software-properties-common
|
|
sudo add-apt-repository ppa:bitcoin/bitcoin
|
|
sudo apt-get update
|
|
sudo apt-get install libdb4.8-dev libdb4.8++-dev
|
|
|
|
Optional:
|
|
|
|
sudo apt-get install libminiupnpc-dev
|
|
sudo apt-get install libzmq3-dev
|
|
|
|
Qt GUI:
|
|
|
|
Use the native depends wallet helper for Qt6:
|
|
|
|
JOBS=1 ./contrib/build-linux-wallet.sh
|
|
|
|
Disable GUI:
|
|
|
|
./configure --without-gui
|
|
|
|
FEDORA
|
|
|
|
Build tools:
|
|
|
|
sudo dnf install which gcc-c++ libtool make autoconf automake openssl-devel libevent-devel boost-devel libdb4-devel libdb4-cxx-devel gmp-devel python3
|
|
|
|
Optional:
|
|
|
|
sudo dnf install miniupnpc-devel zeromq-devel
|
|
|
|
Qt:
|
|
|
|
Native Qt6 builds are currently tested through the Ubuntu depends path.
|
|
Fedora system-Qt builds are not part of the current verified path.
|
|
|
|
HARDENING
|
|
|
|
Enable:
|
|
|
|
./configure --enable-hardening
|
|
|
|
Disable:
|
|
|
|
./configure --disable-hardening
|
|
|
|
Verify:
|
|
|
|
scanelf -e ./agrariand
|
|
|
|
DISABLE WALLET MODE
|
|
|
|
./configure --disable-wallet
|
|
|
|
ARM CROSS COMPILATION
|
|
|
|
sudo apt-get install g++-arm-linux-gnueabihf curl
|
|
|
|
cd depends
|
|
make HOST=arm-linux-gnueabihf NO_QT=1
|
|
cd ..
|
|
./autogen.sh
|
|
./configure --prefix=$PWD/depends/arm-linux-gnueabihf --enable-glibc-back-compat --enable-reduce-exports LDFLAGS=-static-libstdc++
|
|
make
|
|
|
|
SMOKE TESTS
|
|
|
|
After a native build, run:
|
|
|
|
./contrib/smoke-test-daemon.sh
|
|
./contrib/smoke-test-wallet.sh
|
|
./contrib/smoke-test-qt.sh
|