Skip to content

Installation

Build from Source

Instructions to build from source can be found here.

Pre-built executable

If you just want to download and run geth or any of the other tools here, this is the quickest and simplest way.

Binary archives are published at https://github.com/etclabscore/core-geth/releases. Find the latest one for your OS, download it, (check the SHA sum), unarchive it, and run!

With Docker

All runnable examples below are for images limited to geth. For images including the full suite of tools available from this source, use the Docker Hub tag prefix alltools., like etclabscore/core-geth:alltools.latest, or the associated Docker file directly ./Dockerfile.alltools.

docker run

One of the quickest ways to get Ethereum Classic up and running on your machine is by using Docker:

1
2
3
4
5
6
7
8
$ docker run -d \
    --name core-geth \
    -v $LOCAL_DATADIR:/root \
    -p 30303:30303 \
    -p 8545:8545 \
    etclabscore/core-geth \
    --classic \
    --http --http.port 8545

This will start geth in fast-sync mode with a DB memory allowance of 1GB just as the above command does. It will also create a persistent volume in your $LOCAL_DATADIR for saving your blockchain, as well as map the default devp2p and JSON-RPC API ports.

Do not forget --http.addr 0.0.0.0, if you want to access RPC from other containers and/or hosts. By default, geth binds to the local interface and RPC endpoints is not accessible from the outside.

docker pull

Docker images are automatically published on Docker Hub.

Image: latest

Image latest is built automatically from the master branch whenever it’s updated.

1
$ docker pull etclabscore/core-geth:latest

Image: <tag>

version-X.Y.Z Deprecation Notice (2023-01-31)

tl;dr: Use etclabscore/core-geth:v1.12.9 instead of etclabscore/core-geth:version-1.12.9.

~~Repository tags like v1.2.3 correspond to Docker tags like version-1.2.3.~~

Update (2023-01-31)

Docker Hub tags are now formatted as v1.2.3, corresponding exactly with the repository tag (eg. v1.2.3). The previous format (version-X.Y.Z) will be supported through version-1.12.11 (=v1.12.11), but will be discontinued after that.

Example

1
2
$ docker pull etclabscore/core-geth:v1.12.9        # <-- all versions from 1.12.9 and later use this format
$ docker pull etclabscore/core-geth:version-1.11.1 # <-- all versions from 1.12.8 and earlier use this format

Last update: 2023-10-11