Updated 2020-03-01

Migrating from pre-1.2 Docker image to 1.2+

Before v1.2

The Hyperledger Besu Docker image had an entry-script that automatically added options to the Besu command line. You could not set the options using command line arguments.

The options automatically added to the Besu command line for the Besu Docker image before v1.2 were:

The --node-private-key-file command line option was not available and the node key was always read from the data path.

From v1.2

All file options (for example, --config-file) no longer have a default. Add the relevant command line options to your Besu command line and specify the file path.

The --data-path default is now /opt/besu.

The --node-private-key-file default is now /opt/besu/key.


Do not mount a volume at the default data path (/opt/besu). Mounting a volume at the default data path interferes with the operation of Besu and prevents Besu from safely launching.

To run a node that maintains the node state (key and database), --data-path must be set to a location other than /opt/besu and a storage volume mounted at that location.

The host and port options continue to default to the previously set values.


You can set all command line options using environment variables.