Install FydeOS on Orange Pi 5

Ready to unleash the power of FydeOS on your Orange Pi 5 device? This guide will walk you through the installation process for FydeOS (and openFyde) on the entire Orange Pi 5 family, including the Orange Pi 5, 5B, and 5 Plus.

Whether you’re a seasoned SBC enthusiast or new to single-board computers, we’ve made it straightforward. For newcomers, we highly recommend checking out the official Orange Pi documentation and videos to get a grasp of the basics—it’ll make this process even smoother.

1. Download the FydeOS Image

   Let’s start by getting the installation file.

   • For FydeOS: Go to the FydeOS for SBC page and download the image specifically made for the Orange Pi 5 series.
   • For openFyde: Find the latest image on the openFyde release page.

2. Prepare to Run the .run File

   Once downloaded, you’ll have a .run file. This needs to be executed to create the bootable image. Choose your operating system for the next steps:

   macOS / Linux / BSD

   For macOS, Linux, and BSD users, using the terminal is the easiest way to run the .run file. Open your terminal and navigate to the download directory.

   Windows

   Windows users will utilize the Windows Subsystem for Linux (WSL) to execute the .run file.

   1. Install WSL: If you haven’t installed WSL yet, refer to the official Microsoft guide to install WSL.
   2. Open WSL Terminal: Launch your WSL terminal once installation is complete.
   3. Navigate to Downloads: Use the cd command to go to the directory where you downloaded the .run file. Typically, this would be under /mnt/c/Users/YourUsername/Downloads.

3. Grant Execute Permission to the .run File

   Now, we need to allow the .run file to run as an executable. Use the following command in your terminal (macOS/Linux/BSD or WSL):

   chmod +x FydeOS_for_You_OrangePi5family_v17.0-io.run

   Important: Make sure to replace FydeOS_for_You_OrangePi5family_v17.0-io.run with the exact filename of your downloaded .run file.

4. Execute the .run File

   Time to run the .run file! In your terminal, execute:

   ./FydeOS_for_You_OrangePi5family_v17.0-io.run

   Again, ensure you’re using the correct filename.

   After running, an interactive menu will appear:

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

   Follow the prompts to select your Orange Pi 5 model and the desired boot medium (eMMC, NVMe, or SATA, depending on your model).

   The script will then generate the bootable image file. You might see messages like this during the process:

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

   Generating the image may take some time. Once finished, you should see output similar to this, indicating the path to your generated .img file:

   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

   Excellent! You now have a bootable .img file, ready for flashing. You can re-run the .run if needed.

5. Flash the Image to Your Storage Device

   From FydeOS v17 (openFyde r114) onwards, you can directly flash the generated .img file to your target storage (NVMe, SATA, or eMMC) for booting FydeOS. This supports full functionality, including OTA updates! (Older versions required flashing to microSD first.)

   For M.2 NVMe/SATA or eMMC drives, you may need extra hardware to connect them to your computer for flashing. USB M.2 NVMe/SATA enclosures or USB-eMMC readers are recommended.

   Note

   Due to compatibility issues with the latest balenaEtcher, please use one of these methods:

   • Extract the .img file from the .xz file and flash it directly

   • On Windows, use Rufus instead for the most reliable results

   We highly recommend using balenaEtcher to flash the image. It’s user-friendly, cross-platform (Windows, macOS, Linux), and simplifies flashing in three easy steps, as shown:

   

   Download balenaEtcher for your OS from balenaEtcher official website.

   If you’re comfortable with the dd command, it’s also an option. However, use dd with extreme caution, as incorrect usage can overwrite the wrong drive.

6. Boot Up Your Orange Pi 5!

   Almost there! After flashing, carefully insert the storage device into your Orange Pi 5. Connect your keyboard, mouse, and monitor (KVM). Then, power on your Orange Pi 5.

   That’s all there is to it! You’ve successfully installed FydeOS / openFyde. Enjoy your new operating system!

Troubleshooting: Black Screen or No Boot?

If you encounter a black screen or the OS doesn’t boot, here are a few things to check:

• Boot Media Selection: Double-check that the boot media you selected during the .run execution matches the actual storage device you are using (e.g., NVMe, SATA, or eMMC). The boot image is specific to the chosen storage type.

• SPI Firmware: Ensure your Orange Pi 5’s SPI firmware is working and allows booting from your chosen storage (typically NVMe or SATA SSD in the M.2 slot). If you suspect firmware issues, consider using the official Orange Pi OS or Armbian OS to repair or re-flash the SPI firmware.