Files
agrarian/doc/build-ubuntu-24.md
T
2026-04-29 14:11:52 +00:00

2.5 KiB

Copyright (c) 2026 Agrarian Developers

Ubuntu 24.04 Build Notes

These notes describe the native daemon and desktop wallet build paths tested against current Ubuntu 24.04 system packages.

Use at least 2 GB RAM for a reliable build. A 512 MB host with 2 GB swap can configure successfully, but compilation is extremely slow and may time out while building large translation units.

Packages

Install the native daemon build dependencies:

sudo apt-get update
sudo apt-get install -y \
  build-essential pkg-config autoconf automake libtool bsdmainutils \
  libboost-all-dev libevent-dev libgmp-dev libssl-dev \
  libdb5.3-dev libdb5.3++-dev

For the desktop wallet, also install Qt and protobuf tools:

sudo apt-get install -y \
  qtbase5-dev qttools5-dev-tools qtchooser \
  libqrencode-dev libprotobuf-dev protobuf-compiler

Daemon-only build

For the pool daemon, the GUI, tests, bench, ZMQ, and UPnP can be disabled:

./autogen.sh
./configure \
  --without-gui \
  --disable-tests \
  --disable-bench \
  --disable-zmq \
  --with-miniupnpc=no \
  --with-incompatible-bdb \
  CXXFLAGS="-O0 -g0 --param ggc-min-expand=1 --param ggc-min-heapsize=32768"
make -j1

The daemon helper runs the same path:

JOBS=1 ./contrib/build-linux.sh

Qt wallet build

For the desktop wallet, use:

JOBS=1 ./contrib/build-linux-wallet.sh

The wallet helper builds/restores the native depends prefix first, then creates a temporary config.site that keeps the depends libraries while allowing system Qt 5 tools and pkg-config files to be used.

Defaults:

HOST=x86_64-pc-linux-gnu
QT_BINDIR=/usr/lib/qt5/bin
PROTOC_BINDIR=/usr/bin
CONFIG_SITE_FILE=/tmp/agrarian-linux-wallet-config.site

Warnings

Qt 5.15 and protobuf 3.x emit compatibility/deprecation warnings in a few Qt translation units. Those warnings are expected while the Windows build remains pinned to Qt 5.9.7 and protobuf 2.6.1.

OpenSSL 3

Ubuntu 24.04 ships OpenSSL 3. Agrarian no longer rejects this only because RAND_egd is unavailable. Some deprecated OpenSSL SHA calls still warn during compilation; those warnings are expected until the hashing helper code is modernized.

Berkeley DB

Ubuntu 24.04 provides Berkeley DB 5.3. Wallet builds with BDB 5.3 are not portable back to BDB 4.8 wallet environments, so only use wallets created by this build with compatible BDB 5.3 builds.