For AI agents: a documentation index is available at /llms.txt. Markdown versions of pages are available by appending .md to any documentation URL.
Skip to main content

Build from source

caution

If you want to use the latest development version of Teku or a specific commit, build from source. Otherwise, use the binary or Docker image for more stable versions.

Prerequisites

caution

Teku requires Java 25+; earlier versions are not supported.

Installation on Linux / Unix / MacOS X

Clone the Teku repository

Clone the Consensys/teku repository:

git clone https://github.com/Consensys/teku.git

Build Teku

After cloning, go to the teku directory.

Build Teku with the Gradle wrapper gradlew, as follows:

./gradlew distTar installDist
note

The command produces an expanded distribution, ready to run in build/install/teku, and a .tar distribution in build/distribution.

Go to the teku directory:

cd build/install/teku

Display the Teku help to confirm installation:

bin/teku --help
tip

To view the list of available Gradle tasks, run ./gradlew tasks

Continue with Starting Teku.