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
- Assembly (Optional LCD)
- State of Hardware
- 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 and install Web3 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 Web3 Pi Imager on your PC
- Choose the Single Mode Device
For Single Mode device, the following settings can be configured:
- Image version: Default is the latest version of Web3 Pi Image
- Default Ethereum Network: Choice between Mainnet, Sepolia, or Holesky
- Hostname for Raspberry Pi: Use a unique hostname. Default is eop-1.local
- Execution client: Choose between Geth or Disabled
- Execution Port for Geth: 30303
- Consensus Client: Choose between Nimbus or Lighthouse
- Consensus Client Port: 9000
- Enable Grafana Monitoring: Turn on the advanced monitoring system by Grafana
- Format storage: Option to format external storage during installation
If you click the Advanced button, you can configure these additional options:
- Execution endpoint address: Optional custom endpoint for execution client
- Locale settings: Including:
- Time zone selection
- Keyboard layout
- Wireless LAN configuration: Including:
- SSID
- Password
- Wireless LAN country selection
Note: Ethernet connection is recommended
After setting up the configuration and clicking "Next", a dialog box will appear allowing you to select the drive where the image with settings will be saved.
- Drive selection: The list shows available storage devices
- Display options:
- By default, only drives smaller than 300GB are displayed
- Checking the "Show large external storage device" option will display devices larger than 300GB
Note: Make sure you select the correct drive to avoid data loss on other devices
After selecting your target drive, a warning dialog will appear informing you that all data on the selected device will be erased.
- Confirms that all existing data on the selected drive will be permanently deleted
- You must accept the terms to proceed (the "Yes" button remains disabled until accepted). The full Terms of Use can be found at the provided link.
Note: This is your final confirmation before the write process begins - ensure you have selected the correct device
After confirmation, the writing process to the selected storage device begins.
- Writing process: The progress bar displays the current writing status
- Verification phase: After the writing completes, the verification process automatically starts. This step ensures data integrity and proper image installation.
Note: Do not disconnect or remove the storage device until both the writing and verification processes are complete
Now after the card has finished writing you will see a screen informing you about installing the prepared card to the device. Stop Web3 Pi Imager at this step and now we will start assembling the device. We will come back to this step after we finish assembling.
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.
- 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:
Important!
Pay attention to the positioning of the cables when mounting the cover to ensure they don't mechanically obstruct the fan blades.
Important!
Before you connect power, make sure that the ethernet cable is connected with DHCP. Internet connection is required during the installation process.
Now that the device is assembled and the card is inside, go back to the Web3 Pi Imager and follow the instructions
- Connect the necessary cables.
- Ensure Internet connection (via DHCP) is available.
- Turn on the device and then press the NEXT button.
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.
Web3 Pi installer has been successfully written to the SD card.
- At this point, the card is ready, and the installation process on the device begins.
- Now the device is being searched on the network - this may take about 2 minutes, after which the user will be able to monitor the further installation process.
Now you can click the "Track" button - a page with the software installation process on the device will open.
From this point, the user can log in via SSH using the credentials ethereum:ethereum
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.