Skip to content

Install umbrelOS on a Raspberry Pi 5

Jump to bottom
Nathan Fretz edited this page Oct 3, 2024 · 15 revisions

umbrelOS can be installed on a Raspberry Pi 5 in a number of configurations. The two most common are:

  1. Installing umbrelOS on a microSD card and using an external SSD for storage
  2. Booting umbrelOS directly from NVMe or USB

Installing umbrelOS from a microSD card and using an external SSD for storage

In this configuration, you will install umbrelOS on a microSD card and then use a separate external SSD to store your data.

What you will need

  • Raspberry Pi 5
  • Official Raspberry Pi power supply
  • Ethernet cable
  • MicroSD card (32GB or larger)
  • External SSD

Steps

  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 microSD card.

  3. Attach your microSD card to your computer (you may need a microSD card reader).

  4. Flash the umbrelOS image to your microSD card using Balena Etcher. Once the flashing process is complete, safely eject the card from your computer.

  5. Insert the microSD card into your Raspberry Pi 5.

  6. Attach your external SSD to your Raspberry Pi 5 using an available USB port.

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

  8. Power on your Raspberry Pi 5 using the official Raspberry Pi power supply. Third-party power supplies often cannot deliver the required current or maintain a stable voltage, leading to system instability, microSD card corruption, and corruption or data loss on connected hard drives.

  9. 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.

Booting directly from NVMe or USB

In this configuration, you will install umbrelOS directly on an NVMe drive or USB drive, which will be automatically partitioned to store umbrelOS and your data.

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. Booting from NVMe or USB is not supported on Raspberry Pi 4.

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
  • Official Raspberry Pi power supply
  • Ethernet cable
  • Either an NVMe drive + HAT or USB drive (depending on your preference)

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. Third-party power supplies often cannot deliver the required current or maintain a stable voltage, leading to system instability, microSD card corruption, and corruption or data loss on connected hard drives.

  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