How to turn your Raspberry Pi 4 into a node just by flashing the MicroSD card
TL;DR: Flash your Raspberry Pi 4, plug in an ethernet cable, connect the SSD disk and power up the device to turn the Raspberry Pi 4 into a full Ethereum node running the execution layer, or the consensus layer (Beacon Chain / validator)
Some background first. As you know, we’ve been running into some memory issues  with the Raspberry Pi 4 image as Raspbian OS is still on 32bits  (at least the userland). While we prefer to stick with the official OS we came to the conclusion that, in order to solve these issues, we need to migrate to a native 64 bits OS
Besides, consensus clients don’t support 32 bits binaries so using Raspbian would exclude the Raspberry Pi 4 from running a consensus layer node (and the possibility of staking).
So, after several tests we are now releasing 2 different images based on Ubuntu 20.04 64bit : execution layer and consensus layer editions.
Basically, both are the same image and include the same features of the Raspbian based images. But they are setup for running execution layer or consensus layer software by default.
Images take care of all the necessary steps, from setting up the environment and formatting the SSD disk to installing and running the Ethereum software as well as starting the blockchain synchronization.
- Based on Ubuntu 20.04 64bit
- Automatic USB disk partitioning and formatting
- Adds swap memory (ZRAM kernel module + a swap file) based on Armbian work 
- Changes the hostname to something like “ethnode-e2a3e6fe” based on MAC hash
- Runs software as a systemd service and starts syncing the Blockchain
- Includes an APT repository for installing and upgrading Ethereum software
- Includes a monitoring dashboard based on Grafana / Prometheus
Both images include the same packages, the only difference between them is that the execution version runs Geth by default and the consensus version runs Prysm beacon chain by default.
- Geth : 1.9.13 (official binary)
- Parity : 2.7.2 (cross compiled)
- Nethermind : 1.8.28 (cross compiled)
- Hyperledger Besu : 1.4.4 (compiled)
- Swarm : 0.5.7 (official binary)
- Raiden Network : 0.200.0~rc1 (official binary)
- IPFS : 0.5.0 (official binary)
- Statusd : 0.52.3 (compiled)
- Vipnode : 2.3.3 (official binary)
- Raspberry 4 (model B) - 4GB
- MicroSD Card (16 GB Class 10 minimum)
- SSD USB 3.0 disk (see storage section)
- Power supply
- Ethernet cable
- 30303 Port forwarding (execution layer) and 13000 port forwarding (consensus layer) 
- A case with heatsink and fan (optional but strongly recommended)
- USB keyboard, Monitor and HDMI cable (micro-HDMI) (optional)
You will need an SSD to run the Ethereum clients (without an SSD drive there’s absolutely no chance of syncing the Ethereum blockchain). There are 2 options:
- Use a USB portable SSD disk such as the Samsung T5 Portable SSD.
- Use a USB 3.0 External Hard Drive Case with a SSD Disk. In our case we used a Inateck 2.5 Hard Drive Enclosure FE2011. Make sure to buy a case with an UAS compliant chip, particularly, one of these: JMicron (JMS567 or JMS578) or ASMedia (ASM1153E).
In both cases, avoid getting low quality SSD disks as it is a key component of your node and it can drastically affect the performance (and sync times).
Keep in mind that you need to plug the disk to an USB 3.0 port (blue)Download execution layer image
sha256 7fa9370d13857dd6abcc8fde637c7a9a7e3a66b307d5c28b0c0d29a09c73c55cDownload consensus layer image
Insert the microSD in your Desktop / Laptop and download the file (execution layer, for instance):
Note: If you are not comfortable with command line or if you are running Windows, you can use Etcher
Open a terminal and check your MicroSD device name running:
sudo fdisk -l
You should see a device named mmcblk0 or sdd. Unzip and flash the image:
unzip ubuntu-20.04-preinstalled-server-arm64+raspi-eth1.img.zipsudo dd bs=1M if=ubuntu-20.04-preinstalled-server-arm64+raspi-eth1.img of=/dev/mmcblk0 && sync
3. Insert the MicroSD into the Raspberry Pi 4. Connect an Ethernet cable and attach the USB SSD disk (make sure you are using a blue port).
The Ubuntu OS will boot up in less than one minute but you will need to wait approximately 10 minutes in order to allow the script to perform the necessary tasks to turn the device into an Ethereum node and reboot the Raspberry.
Depending on the image, you will be running:
- Execution client: Geth as the default client syncing the blockchain
- Consensus client: Prysm as default client syncing the beacon chain (Prater testnet)
You can log in through SSH or using the console (if you have a monitor and keyboard attached)
User: ethereumPassword: ethereum
You will be prompted to change the password on first login, so you will need to login twice.
6. Open 30303 port for Geth and 13000 if you are running Prysm beacon chain. If you don’t know how to do this, google “port forwarding” followed by your router model.
You can see what’s happening in the background by typing:
sudo tail -f /var/log/syslog
Congratulations. You are now running a full Ethereum node on your Raspberry Pi 4.
Now you need to wait for the blockchain to be synced. In the case of the execution layer this will take a few days depending on several factors but you can expect up to about 5-7 days.
If you are running the consensus layer Prater testnet you can expect 1-2 days of Beacon chain synchronization time. Remember that you will need to setup the validator later in order to start the staking process. How to run the consensus layer validator
For this first release, we included 3 monitoring dashboards based on Prometheus  / Grafana  in order to monitor the node and clients’ data (Geth and Besu). You can access through your web browser:
URL: http://your_raspberrypi_IP:3000User: adminPassword: ethereum
All clients run as a systemd service. This is important because if a problem arises the system will respawn the process automatically.
Geth and Prysm beacon chain run by default (depending on what you are synchronizing, execution layer or consensus layer) so, if you want to switch to other clients (from Geth to Nethermind, for instance), you need to stop and disable Geth first, and enable and start the other client:
sudo systemctl stop geth && sudo systemctl disable geth
Commands to enable and start each execution client:
sudo systemctl enable besu && sudo systemctl start besusudo systemctl enable nethermind && sudo systemctl start nethermindsudo systemctl enable parity && sudo systemctl start parity
sudo systemctl stop prysm-beacon && sudo systemctl disable prysm-beaconsudo systemctl start lighthouse && sudo systemctl enable lighthouse
Clients’ config files are located in the /etc/ethereum/ directory. You can edit these files and restart the systemd service in order for the changes to take effect. The only exception is Nethermind which, additionally, has a Mainnet config file located here:
Blockchain clients’ data is stored on the Ethereum home account as follows (note the dot before the directory name):
These 2 great execution clients have become a great alternative to Geth and Parity. The more diversity in the network, the better, so you may give them a try and contribute to the network health.
Both need further testing so feel free to play with them and report back your feedback.
Once the Prater testnet beacon chain is synchronized you can run a validator in the same device. You will need to follow these participation steps.
The first time, you need to create manually an account by running the “validator” binary and setup a password. Once you have completed this step you can add the password to
/etc/ethereum/prysm-validator.conf and start the validator as a systemd service.
We put a lot of work trying to setup the Raspberry Pi 4 as a full Ethereum node as we know the massive user base of this device may have a very positive impact in the network.
- geth repeatedly crashes with SIGSEGV
- https://github.com/openethereum/openethereum * Note that OpenEthereum has been deprecated and is no longer being maintained. Use it with caution and preferably switch to another client implementation.