Skip to main content
Version: 1.35.0

Building from source

The Nethermind's source code can be obtained from our repository on GitHub:

git clone --recursive https://github.com/nethermindeth/nethermind.git

There are two options building Nethermind from source code:

tip

For reproducible builds, the following conditions must be met:

  • Environment variable CI must be set to true.
  • Environment variable SOURCE_DATE_EPOCH must be set to the same Unix epoch for each build.
  • The SourceRevisionId MSBuild property must be set to the same Git commit hash for each build. This is handled automatically if the .git directory is available in the project root.

Building standalone binaries​

Prerequisites​

To build Nethermind from source, install .NET SDK 9.0.2 or later.

Building​

To build both the client and tests, run the following command from the project's root directory:

dotnet build src/Nethermind/Nethermind.slnx -c release

To simply run the client with a specific configuration without building tests, see below.

info

Before running the client or tests, ensure the platform-specific prerequisites are met.

Running​

Nethermind can be launched immediately without compiling explicitly (thus, the previous step can be skipped). The following command builds Nethermind if needed and runs it:

cd src/Nethermind/Nethermind.Runner
dotnet run -c release -- -c mainnet

All Nethermind-specific parameters can be specified after --. For instance, the command above specifies the Mainnet configuration only.

The build artifacts can be found in the src/Nethermind/artifacts/bin/Nethermind.Runner/release directory. By default, the logs and database directories are located here as well.

For more info, see Running a node.

Testing​

There are two test suites — Nethermind and Ethereum Foundation. Tests can be run with the following commands (the initial step of the build is not required):

cd src/Nethermind

# Run Nethermind tests
dotnet test Nethermind.slnx -c release

# Run Ethereum Foundation tests
dotnet test EthereumTests.slnx -c release

Building Docker image​

tip

Building a Nethermind Docker image does not require cloning the Nethermind source code since Docker can build it directly from the repository. For more information, see the Docker Docs.

Currently, there are three Docker images available in the project's root directory:

  • Dockerfile: the default Nethermind Docker image.
  • Dockerfile.chiseled: the rootless and chiseled version of the Nethermind Docker image.
  • Dockerfile.diag: an image with pre-installed .NET diagnostics and tracing tools. This image is intended for internal use and is not distributed via public channels.

All Docker images have the following optional arguments:

  • BUILD_CONFIG: the build configuration that is either release or debug. Defaults to release.
  • CI: this is mostly used for CI builds determining whether the build is deterministic. Must be either true or false. Defaults to true.
  • COMMIT_HASH: the Git commit hash to use as a part of the version string.
  • SOURCE_DATE_EPOCH: the build time as a Unix timestamp. Defaults to the current time.

Given the above, the following command builds the Nethermind chiseled Docker image from the project's root directory:

docker build . \
  -f Dockerfile.chiseled \
  -t nethermind-chiseled \
  --build-arg COMMIT_HASH=$(git rev-parse HEAD) \
  --build-arg SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)

For quick testing images, the above arguments can be omitted if not needed:

docker build . -t nethermind

An even faster approach is to build the image directly from the repository. The following command builds the version 1.27.0:

docker build https://github.com/nethermindeth/nethermind.git#1.27.0 -t nethermind

The above optional arguments can be specified as well if needed.

For more info about running Docker containers, see Installing Nethermind.