Skip to content

Install umbrelOS on a Raspberry Pi 5

Jump to bottom
Mayank Chhabra edited this page Oct 3, 2024 · 15 revisions

Note

Booting from NVMe or USB instead of a microSD card is only supported on Raspberry Pi 5 for umbrelOS 1.2.0 and later. Raspberry Pi 4 is not supported.

Warning

Certain NVMe drives may not be compatible with specific NVMe HATs. Additionally, some NVMe drives are of poor quality or have reported issues that could affect performance and reliability. It is crucial to check the compatibility of your NVMe drive with the HAT you are using before proceeding. HAT manufacturers typically provide lists of compatible drives and known quality issues on their websites. Using a drive not on the compatible list may result in instability or failure to boot.

What you will need

  • Raspberry Pi 5
  • Either an NVMe drive + HAT or USB drive (depending on your preference)
  • Official Raspberry Pi power supply
  • Ethernet cable

Steps

Note

If you have an early Raspberry Pi 5 model, you may need to update the bootloader firmware in order to be able to boot from NVMe. If this is the case, please follow the official Raspberry Pi documentation on how to update the bootloader firmware: https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#bootloader_update_stable

  1. Download the latest umbrelOS image for Rasberry Pi 5.

  2. Download Balena Etcher on your computer. It is required to flash the umbrelOS image that you downloaded in the previous step to your NVMe or USB drive.

  3. Attach your NVMe drive or USB drive to your computer. For the NVMe drive, you will need to use a USB adapter to connect it to your computer.

  4. Flash the umbrelOS image to your NVMe drive or USB drive using Balena Etcher. Once the flashing process is complete, safely eject the drive from your computer.

  5. Attach the NVMe drive or USB drive to your Raspberry Pi 5.

  6. Connect your Raspberry Pi 5 to your network using an Ethernet cable.

  7. Power on your Raspberry Pi 5 using the official Raspberry Pi power supply.

  8. And that's it! Wait for a few minutes for umbrelOS to boot up. You can access umbrelOS by navigating to http://umbrel.local on any device connected to the same network.

Warning

The boot order on your Raspberry Pi 5 is set to boot from a microSD card preferentially before booting from NVMe or USB. Make sure that you do not have a bootable microSD card inserted when booting from NVMe or USB. If you have a microSD card inserted, the Raspberry Pi 5 will boot from the microSD card instead of the NVMe or USB drive.

Clone this wiki locally