{"id":15750555,"url":"https://github.com/chadsr/ethereum-node","last_synced_at":"2025-10-15T06:31:16.102Z","repository":{"id":44648369,"uuid":"238965776","full_name":"chadsr/ethereum-node","owner":"chadsr","description":"A dockerized Ethereum related node setup (Geth + Swarm + InfluxDB + Grafana)","archived":false,"fork":false,"pushed_at":"2022-02-02T09:52:01.000Z","size":57,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-03-03T22:32:51.948Z","etag":null,"topics":["armv7","armv8","docker-compose","ens","ethereum","ethereum-blockchain","ethereum-node","ethereum-swarm","ethersphere","geth","geth-node","go-ethereum","grafana","grafana-influxdb","swarm","systemd-service"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chadsr.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}},"created_at":"2020-02-07T16:01:04.000Z","updated_at":"2022-11-10T11:53:09.000Z","dependencies_parsed_at":"2022-09-25T00:27:15.025Z","dependency_job_id":null,"html_url":"https://github.com/chadsr/ethereum-node","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2Fethereum-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2Fethereum-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2Fethereum-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2Fethereum-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chadsr","download_url":"https://codeload.github.com/chadsr/ethereum-node/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219869831,"owners_count":16555180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["armv7","armv8","docker-compose","ens","ethereum","ethereum-blockchain","ethereum-node","ethereum-swarm","ethersphere","geth","geth-node","go-ethereum","grafana","grafana-influxdb","swarm","systemd-service"],"created_at":"2024-10-04T06:41:15.385Z","updated_at":"2025-10-15T06:31:10.839Z","avatar_url":"https://github.com/chadsr.png","language":null,"readme":"# Dockerized Ethereum / Swarm Node\n\nA dockerized Ethereum related node setup, using docker-compose.\n\n**Warning(s):**\n- The docker-compose setup builds images locally, since official docker images are only built for x86_64 and I wanted this to compile onto ARM variants as well. Make sure the system has enough resources to do the compilation (1GB of RAM should do).\n- This setup was designed for running on locally networked hardware. I take no responsibility if services are exposed to the Internet and you are not adequately firewalled.\n\n## Config\nSecrets are handled through environment variables, which can be set by renaming `.config.env.example` to `.config.env` and changing account values to your own.\n\nGrafana default credentials are `admin:admin`. Change them as soon as Grafana is up and running.\n\n## Requirements\n- Adequate storage space (Ideally \u003e300Gb. This is a full-node setup, but could be tweaked otherwise)\n- Minimum of 4GB RAM (If you have 4GB, enable a swap partition to avoid issues!)\n- `systemd` (or some equivalent such as `supervisord`)\n- `docker` (With systemd daemon, or equivalent running)\n- `docker-compose`\n- An [Ethereum account](https://github.com/ethereum/go-ethereum/wiki/Managing-your-accounts#creating-an-account)\n\n## Installing\n1. Clone this repository:\n```\ngit clone https://github.com/Chadsr/ethereum_node.git\n```\n\n2. Init and update Git submodules\n```\ngit submodule init\ngit submodule update\n```\n\n3. Copy the example config to `.config.env`:\n```\ncp .config.env.example .config.env\n```\n\n\n4. Edit the values in `.config.env` to your preference.\n\n**Note: An Ethereum account will NOT automatically be generated. It is assumed that you have already [created one](https://github.com/ethereum/go-ethereum/wiki/Managing-your-accounts#creating-an-account).**\n\n### systemd installation\nAn example systemd unit file:\n```\n[Unit]\nDescription=Ethereum Dockerized Services\nRequires=docker.service\nAfter=docker.service\n\n[Service]\nEnvironmentFile=/path/to/ethereum_node/.config.env\nWorkingDirectory=/path/to/ethereum_node\nRestart=always\n\nExecStart=/usr/bin/docker-compose -f compose_files/geth.yml -f compose_files/swarm.yml -f compose_files/metrics.yml up --build\n\nExecStop=/usr/bin/docker-compose down\n\n[Install]\nWantedBy=multi-user.target\n```\n\n1. Write the above to a file named `/etc/systemd/system/ethereum.service`\n and update the working directory to point to the cloned repository.\n\n2. Enable the systemd service:\n```\nsudo systemctl enable ethereum.service\n```\n\n3. Start the systemd service:\n```\nsudo systemctl start ethereum.service\n```\n\n4. (Optionally) monitor the output of your newly running service:\n```\nsudo journalctl -f -u ethereum.service\n```\n\n## Notes\n### Architecture Support\nSince this setup is designed to build the docker images locally, it should work on any common CPU architecture. I am personally running it on aarch64 (ARMv8).\n\n### Geth\n**Current version:** v1.9.25\n\n\n### Swarm\n**Current version:** v0.5.7\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchadsr%2Fethereum-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchadsr%2Fethereum-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchadsr%2Fethereum-node/lists"}