Download and Install
There are 5 images available for NanoPC T6, Rock 5B, Orange Pi 5 Plus, Orange Pi 5 and Raspberry Pi 4
Warning
The Raspberry Pi 4 image is outdated and you may run into issues running the clients. While we will try to update it soon, it is not our priority as this device can barely run an Ethereum node because of hardware limitations.
Getting the hardware
NanoPC T6
You can acquire the NanoPC T6 from the Friendly Elec official site:
You will need a MicroSD and a M2.2280 NVME disk as well.
Rock 5B
You can acquire the Rock 5B from several distributors. These are the recommended components (from Allnetchina):
You will need a MicroSD and an M2.2280 NVME disk as well.
Orange Pi 5 Plus
You can acquire the Orange Pi 5 plus from several distributors. Go to the official page and pick one at the top right corner (make sure you are getting the 16 GB RAM model).
Try to find a set that includes the power supply as well. It is also recommended to get a proper case with a heatsink. For example:
You will need a MicroSD and an M2.2280 NVME disk as well.
Orange Pi 5
You can acquire the Orange Pi 5 from several distributors. Go to the official page and pick one at the top right corner (make sure you are getting the 16 GB RAM model).
Try to find a set that includes the power supply as well. It is also recommended to get a proper case with a heatsink. For example:
You will need a MicroSD and an NVME as well.
Regarding the NVMe disk, take into account there are 2 NVME M.2 types that fit perfectly into the board: 2230 and 2242. You can use a M.2 2280 as well but keep in mind that you will need a hollow enclosure because the drive does not fit on the board.
Raspberry Pi 4
You can acquire a Raspberry Pi 4 from multiples sources. This is the official website.
Make sure you get the 8 GB RAM version.
You will need a MicroSD and an USB3 disk as well. A case with heathsink and the official Raspberry Pi 4 power supply is recommended.
Warning
Again, the image is currently outdated and Post-merge, while it is still possible running a node, the hardware is quite limited. Run Nimbus+Geth clients combo as this is the best option in terms of performance.
Images download
NanoPC T6
Download link:
ethonarm_nanopct6_23.09.00.img.zip
You can verify the file with the following SHA256
Hash:
SHA256 7fc5c22aebf3e334531a7d9aa6ac4df99466954dbff3d5a703f4b50bc48499f7
By running:
sha256sum ethonarm_nanopct6_23.09.00.img.zip
Rock 5B
Download link:
ethonarm_rock5b_23.09.00.img.zip
You can verify the file with the following SHA256
Hash:
SHA256 43f95e9101797523475b3f41f89bdccbfb4b41d0555dba6e3cfb5c6d03510798
By running:
sha256sum ethonarm_rock5b_23.09.00.img.zip
Orange Pi 5 Plus
Download link:
ethonarm_orangepi5-plus_23.09.00.img.zip
You can verify the file with the following SHA256
Hash:
SHA256 e21c0027054533a322bff86365c0f3d733e622f84afdc1bcb17bba16b01e625d
By running:
sha256sum ethonarm_orangepi5-plus_23.09.00.img.zip
Orange Pi 5
Download link:
ethonarm_orangepi5_23.09.00.img.zip
You can verify the file with the following SHA256
Hash:
SHA256 195f8d1173080fc7b4ec1794815ef9ba4312d200f5cd19d6217d36c36cf495f6
By running:
sha256sum ethonarm_orangepi5_23.09.00.img.zip
Raspberry Pi 4
Download link:
You can verify the file with the following SHA256
Hash:
SHA256 fb497e8f8a7388b62d6e1efbc406b9558bee7ef46ec7e53083630029c117444f
By running:
sha256sum ethonarm_22.04.00.img.zip
Image installation
Once you have the Image download and decompressed you need to flash it
Flashing the image
Insert the microSD in your Desktop / Laptop and flash the image.
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 sd(x)
.
Warning
The dd
command will completely erase your MicroSD device so make sure you are targeting
the correct one.
Unzip and flash the image (we are using here the Rock 5B image):
unzip ethonarm_nanopct6_23.08.00.img.zip
sudo dd bs=1M if=ethonarm_nanopct6_23.08.00.img of=/dev/mmcblk0 conv=fdatasync status=progress
Insert MicroSD
Insert the MicroSD into the board. Make sure you have your SSD disk and Ethernet cable connected.
Power on
The Ubuntu OS will boot up in less than one minute and the installation script will start to perform the necessary tasks to turn the device into a full Ethereum node.
Warning
You need to wait for about 10-15 minutes to allow the script to install and configure all the software.
Log in
Once the device is available, You can log in through SSH or using the console (if you have a monitor
and keyboard attached) using the ethereum
account:
User: ethereum
Password: ethereum
Through SSH:
ssh ethereum@your_board_IP
Tip
If you don’t have a monitor with a keyboard you can get your board IP
address by looking into your router
or using some kind of network tool such as fping
or nmap
. For instance (assuming you are in the 192.168.1.0 network)).
In your Linux Desktop / Laptop, run:
Using Nmap
sudo apt-get install nmap
nmap -sP 192.168.1.0/24
Using Fping
sudo apt-get install fping
fping -a -g 192.168.1.0/24
Note
You will be prompted to change the password on first login, so you will need to log in twice.
Image Upgrade
If you are already running an Ethereum on ARM node you can upgrade to the new image by following these steps:
Install the package ethereumonarm-config-sync:
sudo apt-get update && sudo apt-get install ethereumonarm-config-sync
Run the config sync script
ethereumonarm-config-sync.sh
Flash the image as described in the above section and power on the device.
The installer will detect a previous installation (if present) and restore the /etc/ethereum clients config.
Once logged in, restart the clients you were running.
Image re-installation
If you are already running an Ethereum on ARM node and you want a fresh install (disk wipe out), follow these steps:
Log into you node and run the following command:
touch /home/ethereum/.format_me
Follow the steps described in the “Image installation” section