Page tree
Skip to end of metadata
Go to start of metadata


  • Java 11+ 
  • For Mac installations: MacOS High Sierra 10.13 or later

NoteBesu is currently supported only on 64-bit versions of Windows, and requires a 64-bit version of JDK/JRE. We recommend that you also remove any 32-bit JDK/JRE installations.


Building from source has a single dependency- libsodium version 1.0.16 or higher is needed in order to build Besu and run the tests.

If you are not planning on running the tests, you can skip this step.

To install, follow instructions here or type in the following commands on MacOS or Ubuntu.

$ brew install libsodium

Ubuntu (16.04 LTS):
$ apt install libsodium18

Ubuntu (18.04 LTS):
$ apt install libsodium23

Ubuntu (14.04 LTS):

You can find the appropriate package (v1.0.16-0) files here:

The `sudo` command might be needed on Linux, and if the screen prompts you to enter a password, type your password and press enter.


git clone --recursive
cd besu
./gradlew build
./gradlew integrationTest LTS

Checkout source code

git clone --recursive


git clone --recursive

See what tasks are available 

To see all of the gradle tasks that are available:

cd besu
./gradlew tasks  

Build from source

Note: On Windows, to run gradlew, you must have the JAVA_HOME system variable set to the Java installation directory. For example: JAVA_HOME = C:\Program Files\Java\jdk1.8.0_181

Build the distribution binaries: 

cd besu

./gradlew installDist

Run Besu:

cd build\install\besu
./bin/besu --help

Running Developer Builds

Build and run Besu with default options using:

./gradlew installDist

By default this stores all persistent data in build/install/besu.

To set custom CLI arguments for the Besu execution:

cd build/install/besu

./bin/besu --discovery-enabled=false --data-path=/tmp/besutmp
  • No labels