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.