​ Docker repository

Docker repository can be found here:

Supported architectures

We are currently supporting docker images for the following CPU architectures:

• AMD64

• ARM64

Using an existing image

Available tags:

To use one of the previous versions you can pass {tag} e.g. 1.8.50 before the main image name.

For example, if you wish to use version 1.7.4 of Nethermind Debian image, the image name would be nethermind/nethermind:1.7.4.

All versions are available in tags history.

Running Nethermind Container

Docker pull command:

docker pull nethermind/nethermind

In order to start Nethermind.Runner, simply run:

docker run -it nethermind/nethermind

You can use --help to get a list of possible start parameters for Nethermind or you can find them all here.

docker run -it nethermind/nethermind --help

It’s possible to modify each configuration property via environment variable, using a simple convention:

NETHERMIND_{MODULE}CONFIG_{PROPERTY} or --{Module}.{Property}

For example:

NETHERMIND_INITCONFIG_ISMINING=true or --Init.IsMining

JSON RPC

To enable JSON RPC, share the host’s networking namespace with --network host and set--JsonRpc.Enabled true. To change port simply pass--JsonRpc.Port 8550.

If running locally:

docker run -it --network host nethermind/nethermind --JsonRpc.Enabled true

or with port-mapping

docker run -it -p 8545:8545 nethermind/nethermind --JsonRpc.Enabled true --JsonRpc.Host 0.0.0.0

If running from a VM you may want to expose JSON RPC to the outer world via --JsonRpc.Host {hostmachine_ip} (127.0.0.1 is set by default). You may try setting --JsonRpc.Host 0.0.0.0 if you still can not connect with JSON RPC.

Available configurations

To switch the network use --config {network} flag (default value is mainnet).

• mainnet

• goerli

• rinkeby

• ropsten

• xdai

• poacore

• sokol

• volta

• energyweb

For example to run Nethermind on goerli network:

docker run -it nethermind/nethermind --config goerli

Datadir

To successfully map volumes such as database, keystore, logsat one go you can use --datadir command option:

docker run -it -v /home/user/data:/nethermind/data nethermind/nethermind --datadir data

Volumes

To fully override a configuration file, you need to use a volume:

-v /home/user/mainnet.cfg:/nethermind/configs/mainnet.cfg

In order to map an internal database to a local volume, you need to map /nethermind/nethermind_db/:

-v /home/user/nethermind_db:/nethermind/nethermind_db

Logs can be mapped with the following command:

-v /home/user/logs:/nethermind/logs

Keystore:

-v /home/user/keystore:/nethermind/keystore

NLog:

-v /home/user/NLog.config:/nethermind/NLog.config

More detailed NLog configuration can be found here.

Building an image

Dockerfile can be found in the repository root and it currently uses the power of multi-arch builds:

In order to build the images, run:

docker buildx build --platform=linux/amd64 -t nethermind .

Example usage of the locally created docker-image:

docker run -it nethermind --config goerli