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)
Learn about Ethereum upgrades
See more: Setting up ethereum node
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)
- Prysm : 1.0.0-alpha6 (official binary)
- Lighthouse : 0.1.1 (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)
Installation guide and usage
Recommended hardware and setup
- 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)
Image download and installation
1. Download the execution and consensus layer images
Download execution layer image
Download consensus layer image
2. Flash the 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:
You should see a device named mmcblk0 or sdd. Unzip and flash the image:
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).
4. Power on the device
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)
5. Log in
You can log in through SSH or using the console (if you have a monitor and keyboard attached)
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.
7. Get console output
You can see what’s happening in the background by typing:
Congratulations. You are now running a full Ethereum node on your Raspberry Pi 4.
Syncing the Blockchain
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:
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:
Commands to enable and start each execution client:
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):
Nethermind and Hyperledger Besu
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.
How to run the consensus validator (staking)
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/nftgamef.com 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.
Please, take into account that this is the first image based on Ubuntu 20.04 so there may be some bugs. If so, open an issue on GitHub or reach us on Twitter.
- 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.