Skip to main content

Run EthSigner from Docker image

A Docker image is provided to run EthSigner in a Docker container.



The Docker image does not run on Windows.


Display the EthSigner command line help using the Docker image:

docker run consensys/ethsigner:latest --help

latest runs the latest cached version. To pull the latest version, use docker pull consensys/ethsigner:latest.

You can specify environment variables with the docker image instead of the command line options.

Expose listening port

To use the default listening port (8545) or the port specified using --http-listen-port, you must expose the listening port.

To run EthSigner exposing listening port for access:

docker run -p <listenPort>:8545 consensys/ethsigner:latest <options>

To run EthSigner using file-based signing using the default listing port and 8590 as the downstream port:

docker run -p <listenPort>:8545 -v <~/myKeyFile>:/opt/ethsigner/keyfile -v <~/myPasswordFile>:/opt/ethsigner/passwordfile consensys/ethsigner:latest --chain-id=2018 --downstream-http-host=<PantheonHost> --downstream-http-port=8590 --http-listen-host= file-based-signer -k /opt/ethsigner/keyfile -p /opt/ethsigner/passwordfile