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.

Prerequisites

  • Docker

  • MacOS or Linux

    Important

    The Docker image does not run on Windows.

Quickstart

Display the EthSigner command line help using the Docker image:

docker run pegasyseng/ethsigner:latest --help

Note

latest runs the latest cached version. To pull the latest version, use docker pull pegasyseng/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 pegasyseng/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 pegasyseng/ethsigner:latest <options>

Example

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 pegasyseng/ethsigner:latest --chain-id=2018 --downstream-http-host=<PantheonHost> --downstream-http-port=8590 --http-listen-host=0.0.0.0 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 quorum@consensys.net