uphold/geth repository overview

⁠uphold/geth

An Ethereum Go client/full-node implementation docker image.

⁠Supported tags

• 1.4, 1.4.10, latest (Dockerfile⁠)
• 1.4.5

⁠What is geth?

Geth⁠ is the command line interface for running a full Ethereum node implemented in Go. It is the main deliverable of the Frontier Release⁠.

⁠Usage

⁠How to use this image

This image contains the main binary from the Geth project - geth. It behaves like a binary, so you can pass any arguments to the image and they will be forwarded to the geth binary:

$ docker run --rm uphold/geth --dev --rpc

By default, geth will run as user ethereum for security reasons and with its default data dir (~/.geth). If you'd like to customize where geth stores its data, you must use the GETH_DATA environment variable. The directory will be automatically created with the correct permissions for the ethereum user and geth automatically configured to use it.

$ docker run -e GETH_DATA=/var/lib/geth --rm uphold/geth --dev --rpc

You can also mount a directory in a volume under /home/ethereum/.geth in case you want to access it on the host:

$ docker run -v ${PWD}/data:/home/ethereum/.geth --rm uphold/geth --dev --rpc

You can optionally create a service using docker-compose:

geth:
  image: uphold/geth
  command:
    --dev
    --rpc
    --rpcapi "eth,web3"

⁠Supported Docker versions

This image is officially supported on Docker version 1.10, with support for older versions provided on a best-effort basis.

⁠License

The uphold/geth⁠ docker project is under MIT license.