Docker Ethereum Testnet

• Deploy a private Ethereum testnet cluster with netstats using Docker

Additional Features

• Scaleable number of running nodes in the network
• Manage running containers using the Portainer GUI.
• Interact with your private blockchain using Etherwallet (account interface) and Ethersapp (contract interface)

Deploy the Ethereum Testnet

docker-compose up -d

This will build the images and start the containers for:

• 1 Ethereum Bootstrapped container (acts as a primary node for the other nodes to connect)
• 1 Ethereum “Miner” container (which connects to the bootstrapped container on launch)
• 1 Netstats container (with a Web UI to view activity in the cluster) To access the Netstats Web UI: http://localhost:3000
• 1 Addons container which gives you access to Ethersapp and MyEtherWallet. These are accessible via localhost:80/ethersapp and localhost:80/etherwallet

When starting for the first time it will take a few minutes for the miner to generate the DAG before you start seeing mined blocks

Note: you can remove the addons container by removing the last entry in the docker-compose.yml file.

Scaling

If you want additional miners in the test network you can simply run the following command replacing ‘X’ with the number of desired miners.

docker-compose up -d --scale ethminer=X

Test accounts

There are 20 pre-funded accounts included.
Keystore Files and Private Keys can be found in ./files/keystore
You can connect to the network RPC (metamask, remix, mew, etc.) using http://localhost:8545

Managing Cluster

You can manage the containers via the command line or using portainer.

Use the following Docker commands to deploy Portainer:

$ docker volume create portainer_data
$ docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer

Access the Portainer Dashboard via http://localhost:9000

Note: the -v /var/run/docker.sock:/var/run/docker.sock option can be used in Linux environments only.

Interact with geth via commandline

docker exec -it *nameofcontainer* geth attach ipc://root/.ethereum/devchain/geth.ipc

Cleanup Docker (containers and images)

# run the script
./dockerlint.sh
## or manually
docker ps -aq | xargs docker rm -f
docker images -aq | xargs docker rmi -f