microSD Card
High-speed microSD card (preferably 32GB or larger) for storing the operating system and node data files, with plenty of space for future expansions.
Welcome Box
How to Get Running Your Ethereum Node on Raspberry Pi
Step by Step Instruction
Segments:
- Preparation
- Preparing SD Card
- Assembly
- State of Hardware
- Assembly (Optional LCD)
- Monitoring Installation
- Grafana Monitoring
- SSH Access
- Next Steps
- Disclaimer
Preparation
- Open the Web3 Pi Welcome Box and place its content on the table
- Find the microSD card & the USB card reader
- Download latest Web3 Pi Image
- Download and install Raspberry Pi Imager software
Follow the instructions below to write images on the microSD card:
- Insert the microSD card into the card reader and connect the reader to your PC
- Open the Raspberry Pi Imager on your PC
- Choose the device type: Raspberry Pi 5
- From the list select:
"Other specific-purpose OS" and then:
"Web3 Pi"
- Choose the SD card as a target device
- Perform custom configuration
[Edit settings] based on the following instructions
A. General Tab
- Set hostname to eop-1
Important!
During onsite workshops you will get unique name from organizers (e.g. eop-1, eop-2, eop-3 etc.)
Use a unique hostname and write it down, you will need it later.
- Set username as ‘raspberry’ and password as 'raspberry'
(Please, use these specific names) - Set your local settings
- Leave “Configuration wireless LAN” unchecked.
We use cable Ethernet connection with DHCP.
B. Services Tab
- Enable SSH authentication
B. Options Tab
- Make sure that "Eject media when finished" and other options are unchecked
- Click: SAVE to go to the next step.
- Select YES in both of these windows
Source: https://argon40.com/
- Aluminium Top Cover with Screw Points
- Aluminium Case
- Cooling Fins and Exhaust Vent
- Fan Port Access
- POE HAT Connection
- GPIO Access
- MIPI Ports Access
- 30mm PWM Blower-type Fan
- UART Connector
- RTC Battery Connector Access
- PCIe Port Access
- PCIE Film Strip
- Power Button and LED Light
- THRML M.2 Heatsink
- M.2 NVMe Drive Socket
- Place the thermal pads on the CPU, RP1, RAM and PMIC Chip of the RPi 5
There are different versions of this case on the market:- If you have four thermal pads, place them in the areas marked in blue.
- If you have two thermal pads in the set, place them on the CPU and PMIC (bottom left corner, near the USB-C connector).
- Connect the NEO 5 fan to the RPi 5 fan connector as shown in the image. Please pay attention to how the cable is routed.
* There may be a small plug inserted in the fan connector. Remove it.
- Connect the PCIe flat ribbon cable to the Raspberry Pi 5 PCIe port. Be careful when handling brown PCIe flip/cover. Pull up the brown flip to release the lock.
- Drop in the RPi 5 inside the Argon NEO 5 M.2 NVMe Case
* After inserting and pressing the RPi 5 into the central part of the Argon Neo 5 case, they will adhere due to the stickiness of the thermal pads. To ensure good thermal conductivity, do this once and avoid removing the RPi 5 from this part of the case again.
- The PCIe flat ribbon cable should be threaded through the hole in the case, as shown in the picture
- Carefully connect the Raspberry Pi 5 with the PCIe flat ribbon cable with copper facing up to the Argon NEO 5 M.2 NVMe Carrier Board Case. Flip up the cover on the M.2 NVMe Expansion Board
- Here we want you to insert the PREVIOUSLY flashed microSD card with Web3 Pi image
- Connect your M.2 NVMe Drive to the Argon NEO 5 M.2 NVMe Carrier Board. Detailed instructions for this process are described in the following steps.
Connect your M.2 NVMe Drive to the Argon NEO 5 M.2 NVMe Carrier Board. Detailed instructions for this process are described in the following steps.
This Board will accept M.2 Key M and M.2 Key B+M NVMe Storage Drive.
Important!
This Board will accept M.2 Key M and M.2 Key B+M NVMe Storage Drive.
- Remove the "THRMK M.2 Heatsink" cover by unscrewing the four screws at its corners
- Move the screw point on the Board to the appropriate size of your Storage Drive
- Insert the NVMe drive into the M.2 slot as shown in the picture below.
- Screw in the NVMe drive as shown in the picture
- Mount the thermal pad on the NVMe drive. There is no need to shorten it. Remember to remove the protective film from both sides.
- Mount the metal cover and screw it in using four screws with conical heads.
- Secure the Aluminium Top Cover with 2 screws.
Important!
Before you connect power, make sure that the ethernet cable is connected with DHCP. Internet connection is required during the installation process.
- If you have a plastic cover with an LCD display, connect it according to the diagram instead of the original metal one.
* Pay attention to the positioning of the cables when mounting the cover to ensure they don't mechanically obstruct the fan blades.
- The final result should look like this:
* Pay attention to the positioning of the cables when mounting the cover to ensure they don't mechanically obstruct the fan blades.
Important!
Leave the device for about 8-15 minutes to complete the installation process.
Do not disconnect power during this time.
* The time may vary depending on the bandwidth of the internet connection.
You can monitor the installation process through a dedicated website:
http://eop-1.local
The monitoring should start working approximately three minutes after the device is first switched on.
Replace "eop-1" with your hostname that you entered during the microSD card burning process in Raspberry Pi Imager, if you used a name other than "eop-1".
After approximately 3 minutes from powering on the device for the first time, you should see a similar page.
Next, click the link to the Grafana dashboard. If everything has gone smoothly, you should see the login panel. The default username is 'admin', and the password is 'admin'. You will be required to change the password upon first login.
In the Grafana Panel, click on the dashboard named 'Ethereum Nodes Monitor'.
Important!
Pay attention to the status of the consensus and execution clients. Initially, both will be 'inactive'
In the next step, the execution client will change to 'waiting'.
Then both will transition to the 'syncing' state.
Grafana URL: http://eop-1.local:3000
Full synchronization will be achieved when the status of both the execution and consensus clients turns green ("synced").
After the installation completes successfully, you should have SSH access to the Web3 Pi node.
Username: ethereum
Password: ethereum
You can use [your-hostname].local as the SSH address or the IP address if you know it.
If the ‘ethereum’ user does not exist, it means the installation failed unexpectedly (in such case, please contact support).
By default, the 'ethereum' user is required to change the password during the first login.
Download the PDF Instruction
Access detailed instructions to set up your Ethereum Node on Raspberry Pi with our comprehensive guide.
What’s inside?
Power Supply
Official Raspberry Pi 5 power adapter with a USB-C connector. Delivers up to 27W for stable and reliable operation.
Raspberry Pi 5 8GB
The heart of Web3 Pi. Powered by an efficient ARM processor, it delivers high performance while maintaining energy efficiency.
microSD Card Reader
A handy tool for flashing your microSD card with the operating system and node data.
HDMI Cable
Not required for running Web3 Pi, but invaluable for troubleshooting and initial setup.
Ethernet Cable
A 2-meter high-quality Ethernet cable, included to complete the set.
Enclosure with Active Cooling
A compact enclosure with active cooling. It looks sleek, provides excellent thermal management, and fits in any corner.
3D Printed Cover
A custom-designed plastic cover, 3D printed specifically for Web3 Pi. It allows for mounting the LCD display while providing a sleek and functional finish.
Screwdrivers
A set of screwdrivers to tighten screws and secure components. Included to ensure you have everything needed to set up Web3 Pi.
Pliers
Handy pliers that make hardware assembly easier. Ideal for gripping small components and included for your convenience.
Color LCD Dashboard
A high-quality LCD screen designed to provide real-time insights into your node and operating system status.
2TB m.2 Storage
A high-speed 2TB NVMe storage for fast blockchain synchronization. Designed for low power consumption, high performance, and long life.