Skip to content

Build system for generating a custom Web3 Pi OS image tailored for Solo Staking. This project is a fork of the Armbian Linux build framework, modified to produce a dedicated Ubuntu-based image optimized for Ethereum node operation on the Raspberry Pi 5. Key packages and configurations are preinstalled during the build process.

License

Notifications You must be signed in to change notification settings

Web3-Pi/web3-pi-staking-os

 
 

Web3 Pi Staking OS

Web3 Pi Staking OS is a custom Ubuntu-based image built specifically for running a full Ethereum node in a Solo Staking setup on the Raspberry Pi 5.

This project is a fork of the Armbian Build Framework, extended with preinstalled packages, configurations, and system tweaks tailored for Web3 Pi.

The resulting image is designed to be flashed to a microSD card and booted on a Raspberry Pi 5 with an external 2TB drive attached.


🚧 Status

This project is currently in its early development phase and not yet ready for production or public use. Expect frequent changes and incomplete features.


📦 Goals

  • Automated image builds for Ethereum Solo Staking
  • Preconfigured for Raspberry Pi 5 8GB + 2TB storage - WelcomeBox Startet Kit
  • Based on Ubuntu with Armbian enhancements
  • Minimal setup required after flashing
  • Lightweight and optimized for low-resource environments
  • Secure-by-default configuration

🛠 Build Instructions

🐳 Docker is required to build the image.

Clone the repository and start the build:

git clone --branch=w3p-staking-os https://github.com/Web3-Pi/web3-pi-staking-os.git
cd build
./compile.sh w3p

License

This software is published under the GPL-2.0 License license.

About

Build system for generating a custom Web3 Pi OS image tailored for Solo Staking. This project is a fork of the Armbian Linux build framework, modified to produce a dedicated Ubuntu-based image optimized for Ethereum node operation on the Raspberry Pi 5. Key packages and configurations are preinstalled during the build process.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 69.5%
  • Python 9.6%
  • GSC 7.3%
  • JavaScript 5.0%
  • Batchfile 3.0%
  • QML 1.7%
  • Other 3.9%