Skip to content
Last update: November 14, 2021

Run EthSigner from Docker image

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


  • Docker

  • MacOS or Linux


    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.

docker run --mount type=bind,source=/home/me/me_node,target=/var/lib/ethsigner -e ETHSIGNER_CONFIG_FILE=/var/lib/ethsigner/config.toml consensys/ethsigner:latest file-based-signer

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
Back to top