Public | Automated Build

Last pushed: 2 years ago
Short Description
An Ethereum Go client/full-node implementation docker image.
Full Description


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

Supported tags

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.


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:

  image: uphold/geth
    --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.


The uphold/geth docker project is under MIT license.

Docker Pull Command
Source Repository