FluxNode On Raspberry Pi 4b, Official Setup Guide:

Valter is a Sr. Developer at Zelcore Technologies Inc.

“The only way to discover the limits of the possible is to go beyond them into the impossible.”

–Arthur C. Clarke

Raspberry Pi 4b
Flux Cumulus Node — Check the install video!https://youtu.be/pFx1rVL7g6Y
Flux Nimbus Node — Check the install video! https://youtu.be/-OyHVJgX898

What Are The Minimum Requirements?

1.For this guide, we are using SanDisk microSD V30 64Gb SD CARD with SD adapter (recommended min. 64Gb or higher for Cumulus, cheap 16Gb for Nimbus)”

2. Raspberry Pi 4b 4Gb version or 8Gb version, if you plan to host a Nimbus Node in the future

3. Official Raspberry Pi 4b Power adaptor (recommended)

4. Micro HDMI Converter

5. HDMI Cable

6. Ethernet Cable

7. USB Keyboard & Mouse

8. A good quality heatsink case

9. Laptop or Computer PC with USB/SD card reader

10. Powered USB HUB 3.0 (For Nimbus Only)

11. SSD Storage Device with 240Gb with good write speed (For Nimbus Only)

12. USB 3.0 2.5inch HDD Enclosure WITH UASP support (For Nimbus Only)

Note: If you have an existing card, please make sure you back up all the existing data. Delete the partitions and format them in (NTFS). You can also use the “Windows MiniTool Partition Wizard”

Let the fun begin!!

Memory Card (SD Card) Setup

1- Go to https://ubuntu.com/tutorials/how-to-install-ubuntu-on-your-raspberry-pi#2-prepare-the-sd-card

2- Download the correct Raspberry Pi Imager for your Operating system onto your computer.

3- Locate the file & Run/Execute the Raspberry Pi Imager app you just downloaded

4- Open the app & choose the correct OS by pressing and then select Ubuntu -> Ubuntu Server 20.04.2 LTS(RPI 3/4/400), 64bits Edition only

5- On the app, Press & choose SD Card and then select your SD card from the list below

6- Click on Write. (It will download and install the Ubuntu 20 Server on the SD card).

7- After finishing it safely remove the SD Card from Computer OS. (Use the eject option on your computer to remove the card safely from the slot)

Time for the Bootup…

1- Connect the keyboard to the raspberry pi USB port

2- Connect the LAN cable from the router to the Pi ethernet port

3- Connect the Monitor or TV using the HDMI cable & connect it to the micro HDMI converter

4- Insert the micro SD card into the slot. (Please be careful when sliding in the card. It can lead to permanent damage to the slot if not inserted correctly)

5- Lastly, Connect the power cable & power on the device..

Ubuntu steps on Raspberry Pi

1- At this point, when booting up please make sure that you have an internet connection & since this is the first time your system is booting, it may require you to download additional data from the network.

2- Press enter and you will be prompted to log in.

3- Use ubuntu (case-sensitive) for login & password

4- You are required, now to change your password (please make sure you use a strong password)

5- Once the login credentials have been updated, you will get system information with your raspberry Pi local IP. You need to Save or Write this IP

6- Lastly, Disconnect the HDMI and keyboard from raspberry Pi USB ports as they are no longer needed. This will also you some power usage of the Pi.

7- Now, let’s configure raspberry pi from your computer.

Installation Setup using Computer

1- Download Putty or MobaXterm or any other SSH application to login into your raspberry pi

2- Connect to your IP you saved previously. Please use port 22 for SSH. Hit save & open

3- For login use user ubuntu and the new password you have stored

4- On the screen type: sudo apt-get update

5- When last command is completed type: sudo apt-get upgrade -y (It will take a while to update all the packages, so be patient. Do not interrupt the setup process)

6- Change your password by typing: sudo passwd root (Use a secure strong password.)

7- lets change to root user by typing su — (it will ask your root password)

Raspberry Pi Firmware Upgrade

In the next steps, we will begin the process of upgrading the firmware of the Raspberry Pi. It’s mandatory to update your raspberry pi to the latest firmware version, previous versions don’t work 100% with Flux OS.

Note: It’s very important to follow the steps below & type the commands one by one. “Do not skip any of the steps below (Important)”

1- curl -o raspberrypilib1.deb http://ports.ubuntu.com/pool/universe/r/raspberrypi-userland/libraspberrypi0_0~20200520+git2fe4ca3-0ubuntu2_arm64.deb

2- sudo apt install ./raspberrypilib1.deb (if process fails or give a error, redo step 1 and step 2, only move to next step after this step finishes without errors.

3- curl -o raspberrypilib2.deb http://ports.ubuntu.com/pool/universe/r/raspberrypi-userland/libraspberrypi-bin_0~20200520+git2fe4ca3-0ubuntu2_arm64.deb

4- sudo apt install ./raspberrypilib2.deb (if process fails or give a error, redo step 3 and step 4, only move to next step after this step finishes without errors)

5- sudo add-apt-repository ppa:waveform/eeprom (will ask to press enter, press enter to continue)

6- sudo apt update

6- sudo apt install rpi-eeprom -y

8- sudo rpi-eeprom-update (if your version is not the latest one execute the next two commands)

9- sudo rpi-eeprom-update -a

10- sudo reboot

For Nimbus Only

Disconnect your Pi from the power adaptor. It’s time to go back to the beginning of the guide (Let the fun begin!!), and repeat all install processes but this time using the USB enclosure with the SSD, instead of the SD Card. After Image is installed on the SSD, connect the USB HUB to one of the USB 3.0 ports on the Pi, and connect the USB SSD Storage to the hub, DO NOT REMOVE THE MICRO SD CARD FROM THE PI, power it on, and continue with the guide, you can skip the Pi Firmware update, or you can do it again (your decision)

Configure your router to work with Flux

Check this guide: https://medium.com/@tuukkatinkala/guide-for-setting-up-zelnode-in-home-environment-behind-router-8192ec9bf248


From the guide you only need to open tcp/udp from ports 16124 until 16128. Some routers even with open ports don’t work properly, in the end of the process if you cannot connect to your flux from the browser you probably also need to set DMZ on the router to the raspberry Pi internal ip.

Installing Flux Node

Big shout out to Kamil ! We both have worked together, to make the script compatible with ARM64 devices. Once again, thank you for all your help & support..

1- Please go to FluxNode setup medium below Follow the guide and skip the steps from 9 to 11 (read steps bellow after following the guide):


2- On Step 12, For the install process login into your raspberry pi with ubuntu user and switch to root by executing cmd: Type su -

P.S.- I choose No on section 20 of medium (personal option).

NOTE: Install process will take time Please have patience, remember this is an ARM device, and it also depend on your microSD card speed, internet speed.

4- After the installation is successful, you need to reboot your device with cmd type: sudo reboot


💡 Extra Extra Tip

  • Raspberry Pi gets hot if it’s enclosed in a case. Use a proper heat sink, with good ventilation to keep the temperature down.
  • In case, if you can’t get a case built use heatsinks to mount it on

Check Temperature:

Command on ubuntu to check Pi temperature is:

cat /sys/class/thermal/thermal_zone0/temp (result example 53069 means 53ºC)

Command to check clock (MHz):

sudo cat /sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_cur_freq (result example 1500000 means 1500Mhz)

Thank you for supporting our project:

Valter/Cabecinha84 (Zelcore/Flux Developer)

Learn more about Flux here: https://fluxofficial.medium.com/

Blog source for all things Flux, officially; from the Flux Team | https://zel.network/ | https://twitter.com/runonflux

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store