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