Skip to content
You are reading EthSigner development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

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
ConsenSys has acquired Quorum from J.P. Morgan. Please read the FAQ.
Questions or feedback? You can discuss issues and obtain free support on EthSigner Discord channel.
For paid professional support by Consensys, contact us at [email protected].