Ethereum on ARM

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

Light Clients

Layer 1 Execution

Layer 2

Infrastructure & Tools

Web3

⚙️ 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!