Gitian building with Docker

This is a streamlined guide for running Gitian builds with Docker on Ubuntu, Debian or Mac hardware.

Setup

Ensure you have Docker installed. See https://docs.docker.com/get-docker/ for installation instructions.

If you're using Linux, make sure to go through the Linux post-install walkthrough, especially the Manage Docker as a non-root user section, to avoid having to use sudo all the time.

Gitian setup

You only need to do this once:

First, cd into the parent directory of your bitcoin-cash-node repo clone.

# Run the initial Gitian setup
bitcoin-cash-node/contrib/gitian-build.py --docker --setup

# If you need to build for MacOS, also fetch this archive which has been
# extracted from the free SDK. You'll need to first install `curl` if you
# do not already have it.
mkdir -p gitian-builder/inputs
(cd gitian-builder/inputs
curl -LO https://github.com/joseluisq/macosx-sdks/releases/download/14.5/MacOSX14.5.sdk.tar.xz
echo "6e146275d19f027faa2e8354da5e0267513abf013b8f16ad65a231653a2b1c5d MacOSX14.5.sdk.tar.xz" | sha256sum -c)
# This should echo "MacOSX14.5.sdk.tar.xz: OK"

Alternatively, you can skip the macOS build by adding --os=lw below.

Build binaries

Run the build process. Replace 23.1.0 (without the "v") with the version you want to build.

./gitian-build.py --docker --detach-sign --no-commit -b satoshi 23.1.0

See the Verify hashes section of the main Gitian build guide for build verification and signing instructions.