build.md

July 23, 2026 ยท View on GitHub

Building Bisq

  1. Clone Bisq

    git clone https://github.com/bisq-network/bisq
# if you intend to do testing on the latest release, you can clone the respective branch selectively, without downloading the whole repository
# for the 1.10.4 release, you would do it like this:
git clone --recurse-submodules --branch release/v1.10.4 https://github.com/bisq-network/bisq
cd bisq

    If the project was already cloned and you need to update the submodule, run:

    git submodule sync --recursive
git submodule update --init --recursive

  2. Build Bisq

    On macOS and Linux, execute:

    ./gradlew build

    On Windows:

    gradlew.bat build

    If you prefer to skip tests to speed up the building process, just append -x test to the previous commands.

Important notes

  1. You do not need to install Gradle to build Bisq. The gradlew shell script will install it for you, if necessary.

  2. Bisq currently works with JDK 21. You can find out which version you have with:

    javac -version

    If you have multiple JDK versions installed, check which one Gradle will use, with:

    ./gradlew --version

    and if the version number on the JVM line is not a supported one, you can pick the correct JDK at runtime with this syntax (verify your system path):

    JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 PATH=/usr/lib/jvm/java-21-openjdk-amd64/bin:$PATH ./gradlew clean build

If you do not have JDK 21 installed, check out scripts in the scripts directory or download it manually from https://jdk.java.net/archive/.

Running Bisq

Once Bisq is installed, its executables will be available in the scripts folder under the root project directory. Run Bisq Desktop as follows:

On macOS and Linux:

./scripts/desktop

or, to select a specific version of Java:

env JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 ./scripts/desktop

On Windows:

scripts\desktop.bat

See also