agrarian/doc/build-unix.md

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