Last Update: 2023-08-21

This guide will walk you through the process of booting FydeOS / openFyde on your Orange Pi 5 family, including Orange Pi 5 / 5B / 5 Plus. Simply follow the instructions tailored to your OS, and you'll be up and running with FydeOS / openFyde in no time.

As the nature of the Orange Pi 5 family, it's recommended to first familiarise yourself with basic processes and best practices of using / operating / tinkering with single board computers like the Orange Pis, by reading their official documentation and watch video demonstrations available from their .

#Step 1: Download the installation file

If you want FydeOS, start by visiting the page and downloading the installation file specifically for Orange Pi 5. For openFyde, please obtain the latest image from the .

#Step 2: Prepare to execute the .run file

Once the download is complete, you'll have a .run format file. As the name suggests, we need to "run" this file first.

Note: For macOS, Linux, and BSD users, you can directly execute the .run file using the terminal. Windows users will need to use the Windows Subsystem for Linux (WSL) to execute the file. Follow steps 3-5 accordingly.

• For macOS, Linux, and BSD: Open the terminal and navigate to the folder containing the .run file.

• For Windows: First, install the Windows Subsystem for Linux (WSL) on your computer by following the from Microsoft. After installing WSL, open the WSL terminal and navigate to the folder containing the .run file.

#Step 3: Make the .run file executable

Next, execute the following commands in the terminal. Replace FydeOS_for_You_OrangePi5family_v17.0-io.run with the name of your downloaded .run file:

chmod +x FydeOS_for_You_OrangePi5family_v17.0-io.run

#Step 4: Run the .run file

Now, you can run the .run file by executing the following command:

./FydeOS_for_You_OrangePi5family_v17.0-io.run

After executing these commands, the terminal will display an interactive menu, like this:

*****************************
* Supported boards *
*****************************
[1] orange pi 5
[2] orange pi 5b
[3] orange pi 5 plus
[4] Quit
-----------------------------
Enter your choice:

Now you need to follow the screen prompt and enter your choice (number 1 - 4). The interactive prompt will ask you to select your board from the Orange Pi 5 family as well as the boot medium (eMMC, NVMe or SATA, depending on the support of specific model). Once you've made your choices, the script will begin to generate a bootable image file for you and display the following:

*****************************
* board: orangepi5plus, supported install storage: nvme *
*****************************

The generation process can take a few minutes or even longer, please be patient. Once it finishes, it may prompt you:

board: orangepi5plus storage: NVME
Generated image: /some/path/FydeOS_for_You_OrangePi5family_v17.0-io.img
Installing uboot firmware on ./FydeOS_for_You_OrangePi5family_v17.0-io.img
Installed bootloader to ./FydeOS_for_You_OrangePi5family_v17.0-io.img

Now you have the bootable img file per your selection. You can always re-run the .run file to retry the process if need be.

#Step 5: Flash the generated image file to the target storage device

Beginning from FydeOS v17 (openFyde r114), you can flash the generated bootable image directly to the storage device that you will be using to boot FydeOS and enjoy the full functionalities including OTA updates (unlike previously, you would have to flash the image onto a micro SD card first and perform an installation process to the final destination storage drive).

To write files onto M.2 NVMe/Sata storage drives or an eMMC chip, additional hardware may be required to interface with these storage devices. We recommend using a USB M.2 NVMe/Sata drive enclosure or a USB - eMMC reader to do this.

We recommend using to write the image to a USB device. BalenaEtcher is a user-friendly tool compatible with Windows, macOS, and mainstream Linux versions. It allows users to swiftly write image files to USB devices or flash memory cards in just three simple steps:

You can download the installation package for your OS from the .

Alternatively, if you're comfortable with the command, you can directly write the generated .img file to the target storage device.

#Step 6: Power on your Orange Pi 5

After successfully writing the image to the target storage device, securely insert it onto your Orange Pi 5 device, also connect your KVM kits(keyboard, mouse and video) and power it on. This completes the FydeOS / openFyde installation process. Enjoy exploring your new OS!

#What to do in case of a black screen or OS doesn't boot?

Due to the uniqueness of ARM powered SBCs, the system boot process differs significantly from traditional x86 devices. For the Orange Pi 5 family devices, you need to ensure that the SPI firmware allows the device to boot from the storage device you have installed, typically an NVMe or Sata SSD in the M.2 slot. If you encounter issues booting from an SSD in the M.2 slot, please ensure the following:

• Make sure that the boot media selected when executing the .run file matches the one you are using; if you chose the M.2 NVMe, the boot image will not work on the M.2 Sata SSD;
• Ensure that your SPI firmware has not been modified or damaged. If uncertain, you can use the official Orange Pi OS or Armbian OS to repair the SPI firmware.