{"id":19391130,"url":"https://github.com/asone/eth-toolbox-docker","last_synced_at":"2026-05-05T08:36:35.808Z","repository":{"id":82334281,"uuid":"142220543","full_name":"Asone/Eth-Toolbox-Docker","owner":"Asone","description":"A docker set of ethereum development tools","archived":false,"fork":false,"pushed_at":"2018-08-08T08:51:23.000Z","size":27,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-29T14:01:13.034Z","etag":null,"topics":["clixplorer","containers","docker","docker-compose","ethereum","ganache-cli","geth","myetherwallet","poa","truffle"],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Asone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-24T22:51:45.000Z","updated_at":"2023-10-31T08:02:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"e15bf432-8aad-45e9-8290-6d1f7e1824c4","html_url":"https://github.com/Asone/Eth-Toolbox-Docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Asone/Eth-Toolbox-Docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asone%2FEth-Toolbox-Docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asone%2FEth-Toolbox-Docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asone%2FEth-Toolbox-Docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asone%2FEth-Toolbox-Docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Asone","download_url":"https://codeload.github.com/Asone/Eth-Toolbox-Docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asone%2FEth-Toolbox-Docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32642274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"online","status_checked_at":"2026-05-05T02:00:06.033Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clixplorer","containers","docker","docker-compose","ethereum","ganache-cli","geth","myetherwallet","poa","truffle"],"created_at":"2024-11-10T10:25:01.679Z","updated_at":"2026-05-05T08:36:35.792Z","avatar_url":"https://github.com/Asone.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# (WIP) Ethdev toolbox docker\n\n**DISCLAMER : This is a Work In Progress project and all services might not be functional yet.**\n\nA set of Docker images to ease the install, config and use of ethereum protocol. \n\nIt provides the following containers : \n- [`Geth + Eth-netstats`]() : Local PoA Ethereum chain and monitoring ✅\n- [`ganache-cli`]() : Local Dev network with Ganache-cli ✅\n- [`remix-ide`]() : Smart-contract IDE for development \u0026 debug ❌ (1)\n- [`MyEtherwallet`]() : Ethereum Wallet manager ✅\n- [`Clixplorer`]() : Block explorer for PoA network ✅\n- [`PoA Explorer`]() : Block explorer for PoA network ❌ \n- [`Truffle`]() : Smart-contracts compiler and unit tester ✅\n- [`IPFS`]() : local IPFS node ❌\n\n\nPlease, note that **it is NOT recommended to start all services at once** as some tools are redundant and many libraries quite heavy to install and run. It is **instead** recommended to **pick what services to launch and customize the configuration provided in `docker-compose.yml`** instead.\n\n## Local Ethereum Network\n\nA set of Docker images to create a local Ethereum network with three nodes and a monitor. This was built to understand how local Ethereum networks have to be set up and to provide a local test environment. **Never use this in a productive environment, as the docker-compose.yml contains hardcoded passwords and private keys for convenience** \n\n### Usage\nrun `docker-compose up geth-bootnode geth-dev-miner-1 geth-dev-miner-2 geth-dev-miner-3 geth-monitor-backend geth-monitor-frontend` from the repository root.\n\n It will run the required services for running a PoA network with monitoring.\n\n The network should start and synchronize without any further configuration. It is using the Clique protocol (Proof-of-Authority), so the network runs very efficiently and does not use a lot of energy.\n\nThe started  services are described below in the next paragraphs.\n\n### The bootnode\nThe nodes in the network are connecting with the bootnode. This is a special ethereum node, designed to provide a register of the existing nodes in the network. The parameter `nodekeyhex`in the `docker-compose.yml` is needed to derive the `enodeID` which is later passed to the other nodes. The IP needs to be fixed, as the other nodes need to know where to find the bootnode, and DNS is not supported. The bootnode does not participate in synchronization of state or mining.\n\n### Miners / Geth Nodes\nThere are three nodes that participate in the network. The state is synchronized between them and they are trying to create blocks with mining. Initially they connect to the bootnode with the information derived from the fixed IP and the nodekeyhex. If you want to interact with the network, you need to connect via RPC. You can attach a geth instance, connect Remix IDE or connect your browser with web3 and build a ÐApp.\n\nThe RPC Ports of the nodes are mapped to your localhost, the addresses are:\n\n* [http://localhost:8545](http://localhost:8545) - geth-miner-1\n* [http://localhost:8546](http://localhost:8546) - geth-miner-2\n* [http://localhost:8547](http://localhost:8547) - geth-miner-3\n\n### Monitoring\nThe monitoring is being provided by two nodes, the monitoring-backend and the monitoring-frontend. The backend connects to the ethereum nodes and retrieves metrics from them. It communicates with the monitoring-frontend with websockets. The frontend can be found under [http://localhost:3000](http://localhost:3000)\n\nprovided by : [javahippie](https://github.com/javahippie/geth-dev) \n\n## Ganache-cli RPC Client\n\nA fast RPC client for development and testing. \n\n### Usage\nrun `docker-compose up ganache`. You should be able to connect through[localhost:8585]().\n\nPort has been changed to avoid conflict with miners.\n\n### Configuration\nYou can configure [ganache-cli parameters]() of ganache-cli in the  `docker-compose.yml` file. \n\n## Truffle\nTruffle is a smart-contract development framework which provides unit testings, ABI generation and deployment strategy for smart-contracts.\n\n### Usage\n\nOn build service will create a default truffle project in `./smart-contracts/` if it is empty. \n\nuse run `docker-compose exec truffle truffle \u003ctruffle command\u003e` to use the service. \n\ne.g : \n - compile: `docker-compose exec truffle truffle compile`\n - deploy: `docker-compose exec truffle truffle deploy`\n - migrate: `docker-compose exec truffle truffle migrate`\n - test: run `docker-compose exec truffle truffle test` \n\ntruffle files should be stored in this directory. \n\n\n## Remix IDE \n\nA web interface for developping, debugging and compilation test smart-contracts\n\n### [TODO] Usage\n\n### [TODO] Configuration \n\n## nginx\n\nAn nginx container is configured to access static web applications like [Clixplorer]() or [MyEtherWallet](). \n\nnginx will be started for any of those containers.\n\nTo access : \n- [Clixplorer]() : go to [localhost/Clixplorer](http://localhost/Clixplorer) \n- [MyEtherWallet]() : go to [localhost/etherwallet](http://localhost/etherwallet/dist/)\n### Usage\n\nrun `docker-compose up nginx` to launch server. \n\n### Configuration\n\n\n\n## My Ether Wallet\n\nMyEtherWallet is an open-source online Ethereum wallet manager. If you don't feel confident on manipulating wallets on third-party service this container installs and deploys your own instance of the service.\n\n### [TODO] Usage\n\n\n\n## [TODO] Truffle\n\n### [TODO] Build \n\n### [TODO] Test\n\n## Clixplorer\n\nA block explorer for PoA Eth network. \n\nProvided by [Magicking](https://github.com/Magicking/Clixplorer)\n\n### Usage \n\nrun `docker-compose up clixplorer` and connect to [localhost:xxxx](http://localhost:xxxx). \n\n### [TODO] Configuration \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasone%2Feth-toolbox-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasone%2Feth-toolbox-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasone%2Feth-toolbox-docker/lists"}