Support
DeviceFreedom PhoneDeviceFreedom Tabdevicefreedom-osApp Store
DeviceFreedom Tab & Pro vs. DIYInstalling devicefreedom-os on Raspberry PiInstalling devicefreedom-os on amd64Installing devicefreedom-os in a virtual machine
DeviceFreedom PhoneDeviceFreedom Tabdevicefreedom-osApp Store

Installing devicefreedom-os on Raspberry Pi

Updated February 21, 2026

devicefreedom-os is designed for DeviceFreedom Tab and DeviceFreedom Phone, but it can also run on a Raspberry Pi 5. Some features are unavailable on DIY hardware — see DeviceFreedom Tab & Pro vs. DIY for details.

For the best experience, we recommend installing directly onto an NVMe or USB drive rather than a microSD card.

What you'll need

  • Raspberry Pi 5
  • Official Raspberry Pi power supply
  • Ethernet cable
  • NVMe drive with a compatible HAT, or a USB drive
  • A computer to flash the image

Install devicefreedom-os

  1. Download the latest devicefreedom-os image for Raspberry Pi 5.
  2. Download and install Balena Etcher or Raspberry Pi Imager on your computer.
  3. Connect your NVMe or USB drive to your computer (use a USB adapter for NVMe drives).
  4. Open Balena Etcher, select the devicefreedom-os image, select your drive, and flash it.
  5. Safely eject the drive from your computer.

Boot your Raspberry Pi

  1. Attach the flashed drive to your Raspberry Pi 5.
  2. Remove any microSD cards — otherwise the Pi may boot from the card instead.
  3. Connect an ethernet cable to your Pi and your router.
  4. Connect the official power supply to power on.
  5. Wait a few minutes for the first boot to complete, then open http://devicefreedom.local in your browser.

See Connecting to your DeviceFreedom if you need help accessing it.

Notes

  • Early Pi 5 models may need a bootloader update to support NVMe booting. See the Raspberry Pi documentation for instructions.
  • NVMe compatibility varies by HAT — check that your drive is compatible before purchasing.
  • Always use the official power supply. Third-party supplies can cause stability issues.

Why not microSD?

You can flash devicefreedom-os onto a microSD card and use an external SSD for storage, but we don't recommend it. microSD cards have a limited number of write cycles and degrade faster, leading to lower performance and reliability over time.

Previous

DeviceFreedom Tab & Pro vs. DIY

Next

Installing devicefreedom-os on amd64