Web3 Pi Welcome Box
How to Get Running Your Ethereum Node on Raspberry Pi
Choose your tutorial
Select the tutorial that best fits your needs.
.svg)
Open the Web3 Pi Welcome Box and place its content on the table
Find the microSD card & the USB card reader
Download latest Web3Pi 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
Choose the downloaded Web3 Pi OS Image as a source image (“Use custom” option on the bottom of the list)
Select: Web3Pi_Single_Device.img.xz
~ 1GB
Choose the SD card as a target device
Click NEXT
Perform custom configuration [Edit settings] based on the following instructions
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.
Services Tab
Enable SSH authentication
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
Wait until the image is flashed onto the SD card
Do not interrupt verification step
While waiting for SD Card to be flashed (written) and verified you can start the assembly process of the Raspberry Pi hardware
Please follow the instructions from the case manufacturer (Argon Neo 5):
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
Some parts are in two zipper bags. Open them and carefully pour out the contents. You will find:
- Screws (two types)
- Rubber feet
- Two ribbon cables. You need one, the other one is a spare
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
Secure the bottom cover with 4 screws as shown in the image. Do not apply excessive force to avoid stripping or damaging the thread
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.
* This Board is NOT compatible with M.2 SATA Storage Drives.
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
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.
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.
The Raspberry Pi with the Web3 Pi image on port 80 hosts an HTTP server that continuously displays the following in the web browser:
- The installation stage
- The hostname and IP address of the device
- The full installation log and uptime
- A link to the Grafana dashboard and a JSON status file
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.
The installation is divided into stages. The installation is complete when you see: "STAGE 100: Installation completed." This status is shown in the following screenshot.
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'.
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
At this point, the blockchain synchronization process will begin and will take approximately 19 hours.
The CPU load will increase until it reaches its maximum possible value.
Disk usage will grow to around 1.2TB.
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.
Now you can follow these instructions to install and run Web3 Pi Reverse Proxy https://docs.proxy.web3pi.io/installation/
Follow the instructions below to write images on the microSD card.
Node Setup https://setup-guide.web3pi.io/
Raspberry Pi Argon Neo 5 Case: INSTRUCTION_MANUAL_NEO_5_M.2_NVMe_20240703.pdf
Source: https://argon40.com/
Recommended Hardware: https://setup-guide.web3pi.io/Hardware/recommendedHW/
More on Web3 Pi Reverse Proxy: https://docs.proxy.web3pi.io/
The Web3 Pi is a community driven project and it is currently in its early development phase (Proof of Concept) and consists of components provided by third-party manufacturers, including but not limited to Raspberry Pi, enclosures, power supplies, storage drives, microSD cards, etc. While the Web3 Pi team rigorously tests all functionalities, we cannot guarantee the performance or compatibility of individual components or solutions at this stage.
By engaging with Web3 Pi products during this early phase of development, the “Early Bird” user assumes full responsibility for any interactions with these products. The use of Web3 Pi solutions is at the user’s own risk, and the team does not bear any liability for issues that may arise during this period of initial testing and experimentation.
Open PDF Instruction
