Last update: April 2, 2021

Install binary distribution

MacOS with Homebrew

Prerequisites

Homebrew
Java JDK.

Important

Hyperledger Besu requires:

MacOS High Sierra 10.13 or later versions
Java 11+ to compile. Earlier versions are not supported. You can install Java using brew install openjdk. Alternatively, you can manually install the Java JDK.

Install (or upgrade) using Homebrew

To install Besu using Homebrew:

brew tap hyperledger/besu
brew install hyperledger/besu/besu

To upgrade an existing Besu installation using Homebrew:

brew upgrade hyperledger/besu/besu

To display the Besu version and confirm installation:

besu --version

To display Besu command line help:

besu --help

Linux / Unix

Prerequisites

Java JDK

Attention

Besu requires Java 11+ to compile. Earlier versions are not supported.

Linux Open File Limit

If synchronizing to MainNet on Linux or other chains with large data requirements, increase the maximum number of open files allowed using ulimit. If the open files limit is not high enough, a Too many open files RocksDB exception occurs.

Install from packaged binaries

Download the Besu packaged binaries.

Unpack the downloaded files and change into the besu-<release> directory.

Display Besu command line help to confirm installation:

bin/besu --help