Skip to content

Running Gitian with Docker on Ubuntu/Debian

This is a streamlined guide for running Gitian builds with Docker on Ubuntu or Debian hardware. The following steps have been tested on Ubuntu 18.04.05. Similar, if not the same steps should work on other versions of Ubuntu and Debian.


Ensure you have Docker installed. See for installation instructions.

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.

Prepare a workspace directory (e.g. ~/bchn-gitian) and cd into it. You'll only need to run through this setup once so long as you retain the workspace.

# Install dependencies
sudo apt install curl git

# Fetch the `` script
git clone
cp bitcoin-cash-node/contrib/ .

# Run the initial Gitian setup
./ --docker --setup

# If you need to build for MacOS, also fetch this archive which has been
# extracted from the free SDK.
mkdir -p gitian-builder/inputs
(cd gitian-builder/inputs
curl -LO
echo "0f03869f72df8705b832910517b47dd5b79eb4e160512602f593ed243b28715f MacOSX10.14.sdk.tar.xz" | sha256sum -c)
# This should echo "MacOSX10.14.sdk.tar.xz: OK"

Build binaries

Finally, use the following command to run the build process. Replace satoshi with your GitLab name and replace 23.1.0 with the most recent tag (without the "v"). Use the latest released version available.

./ --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.