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.11.00.img.zip

You can verify the file with the following SHA256 Hash:

SHA256 66d868bcf1d0e0e88c92a3776aeb8dc699a31f3c7f338d2aeca171064d94d9dd

By running:

sha256sum ethonarm_nanopct6_23.11.00.img.zip

Rock 5B

Download link:

ethonarm_rock5b_23.11.00.img.zip

You can verify the file with the following SHA256 Hash:

SHA256 9460652f68dcc91517faf19b6c27c7efdf7a015ccc42912dbfa59b30ce19fcba

By running:

sha256sum ethonarm_rock5b_23.11.00.img.zip

Orange Pi 5 Plus

Download link:

ethonarm_orangepi5-plus_23.11.00.img.zip

You can verify the file with the following SHA256 Hash:

SHA256 8eac865a72938fac63c78247d9a4a1e61a432829c51d80e8c56753372e0a8d64

By running:

sha256sum ethonarm_orangepi5-plus_23.11.00.img.zip

Orange Pi 5

Download link:

ethonarm_orangepi5_23.11.00.img.zip

You can verify the file with the following SHA256 Hash:

SHA256 7d8f1647b7729678438f9438a80a95fc6a1b99a799d5082c2121123391c227e4

By running:

sha256sum ethonarm_orangepi5_23.11.00.img.zip

Raspberry Pi 4

Download link:

ethonarm_22.04.00.img.zip

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:

  1. Install the package ethereumonarm-config-sync:

sudo apt-get update && sudo apt-get install ethereumonarm-config-sync
  1. Run the config sync script

ethereumonarm-config-sync.sh
  1. 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:

  1. Log into you node and run the following command:

touch /home/ethereum/.format_me
  1. Follow the steps described in the “Image installation” section