Skip to content

EOA-Blockchain-Labs/ethereumonarm

Ethereum on ARM

Repository Release Docs Discord Twitter Bluesky Farcaster License GitPOAP Badge

Ethereum on ARM is a project that makes it easy to run a full Ethereum node on low-power ARM devices. We provide Plug-and-Play (PnP) Ubuntu/Armbian images for a variety of ARM64 boards, allowing users to easily set up and maintain both execution and consensus nodes.

Our main goal is to lower the barrier to entry so more people can participate in the Ethereum network, either by running a full node or by staking from home.

✨ Main features

  • Graphical User Interface (EOA-gui): A console menu that simplifies the setup of L1/L2 nodes, for both full and archive nodes (currently in alpha).
  • Extensive Protocol Support: Full support for L1 Consensus & Execution clients, Layer 2 networks, and DVT infrastructure.
  • Client diversity: We actively promote the use of minority clients.
  • Testnet ready: Full support for Sepolia, Holesky, and Ephemery testnets.
  • Advanced monitoring: Ready-to-use dashboards with Prometheus and Grafana for detailed tracking of your node's performance.
  • Optimized operating system: Custom configurations on top of Armbian to ensure your node is stable and efficient.

πŸ“¦ Supported Software

We support a wide range of Ethereum software, all packaged as standard .deb files for easy management.

Layer 1 Consensus

Client Repository
Grandine grandinetech/grandine
Lighthouse sigp/lighthouse
Lodestar ChainSafe/lodestar
Nimbus status-im/nimbus-eth2
Prysm prysmaticlabs/prysm
Teku ConsenSys/teku

Light Clients

Client Repository
Helios a16z/helios

Layer 1 Execution

Client Repository
Besu hyperledger/besu
Erigon ledgerwatch/erigon
EthRex lambdaclass/ethrex
Geth ethereum/go-ethereum
Nethermind NethermindEth/nethermind
Nimbus EL status-im/nimbus-eth1
Reth paradigmxyz/reth

Layer 2

Component Repository
Arbitrum Nitro OffchainLabs/nitro
EthRex L2 lambdaclass/ethrex
Fuel Core FuelLabs/fuel-core
Linea Besu Consensys/linea-monorepo
Maru Consensys/maru
Optimism (Components) ethereum-optimism/optimism
Optimism Cannon ethereum-optimism/optimism
Optimism Kona ethereum-optimism/optimism
Optimism (op-geth) ethereum-optimism/op-geth
Optimism (op-reth) paradigmxyz/reth
Starknet Juno NethermindEth/juno
Starknet Madara madara-alliance/madara
Starknet Pathfinder eqlabs/pathfinder
zkSync Era matter-labs/zksync-era

Infrastructure & Tools

Tool Repository
Commit-Boost Commit-Boost/commit-boost-client
DVT Anchor sigp/anchor
Obol Charon ObolNetwork/charon
SSV Node ssvlabs/ssv
MEV-Boost flashbots/mev-boost
Lido Liquid Staking lido.fi
Vouch attestantio/vouch
Vero serenita-org/vero
Eth. Metrics Exporter ethpandaops/ethereum-metrics-exporter
Val. Metrics Exporter ethpandaops/ethereum-validator-metrics-exporter
EthStaker Deposit CLI eth-educators/ethstaker-deposit-cli
StakeWise Operator stakewise/v3-operator

Web3

Application Repository
Swarm Bee ethersphere/bee
IPFS Kubo ipfs/kubo
Status-Go status-im/status-go

βš™οΈ Supported devices

  • NanoPC-T6
  • Rock 5B
  • Rock 5T (Rock 5 ITX)
  • Orange Pi 5 Plus
  • Raspberry Pi 5

πŸ“‚ Project Structure

This repository is organized into several key components:

  • fpm-package-builder: Contains the tooling, Makefiles, and scripts used to build Debian (.deb) and RPM packages for all supported Ethereum clients and utilities. This system uses a Docker-based workflow to ensure reproducible builds across different environments.
  • image-creation-tool: Scripts and configurations for generating the custom Ubuntu and Armbian images that come pre-configured with our optimizations.
  • docs: Source files for our official documentation.

πŸ“¦ Package status

For a detailed list of all supported packages and their current status, please see our Status Page.

πŸš€ Installation

Using our Images (Recommended)

To get started quickly, we recommend using our pre-built images. Please follow our step-by-step installation guide.

Building from Source

If you prefer to build packages yourself or contribute to the project, check out the Package Builder README for detailed instructions on setting up a build environment.

🀝 Community and support

  • Discord: Join our Discord channel to get help, discuss ideas, or chat with other community members.
  • X/Twitter: Follow us on @EthereumOnARM to stay updated with the latest news.

πŸ”’ Security Standards

Security is our top priority. All software packages in this repository are:

  1. Verified: Every binary is verified against its upstream SHA256 checksum or GPG signature before being packaged.
  2. Isolated: Software runs with dedicated user permissions, never as root (unless strictly required by the OS).
  3. Auditable: Our build system (fpm-package-builder) is open source, allowing anyone to verify exactly how packages are constructed.

πŸ’– Acknowledgements

This project is possible thanks to the support and donations from our amazing community. Thank you all!

About

Tools and scripts to build images that turn ARM devices into ful Ethereum nodes

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors 24