Skip to content

Repository files navigation

umbrelOS

umbrelOS

A beautiful home server OS for self-hosting
umbrel.com »

Get an Umbrel Pro or Umbrel Home, or download umbrelOS for free on an Intel or AMD machine, Raspberry Pi 5, or a virtual machine.


At Umbrel, we believe that everyone should be able to enjoy the convenience and benefits of the cloud, without giving up ownership and control of their data.

To achieve our vision, we're building a new kind of a home server OS. Just like the cloud, but one that you own and control.


umbrelOS 2.0

bento 2 0

umbrelOS 2.0 is currently in beta, with the stable release planned for September 22, 2026. Try it out today:

  • Fresh install: download the 2.0 beta from umbrel.com/downloads.
  • Already on umbrelOS: update to umbrelOS 1.7.4 or later, then go to Settings > Advanced settings and turn on umbrelOS beta program to receive the 2.0 beta.

Installing umbrelOS

umbrelOS is free and complete on any hardware. The image you install on your own device is the same umbrelOS that ships on Umbrel Home and Umbrel Pro, with the same features and the same updates.

Supported devices

  • Intel and AMD devices: umbrelOS supports most 64-bit mini PCs, laptops, desktops, NAS boxes, and servers. Minimum requirements: Dual-core CPU, 4 GB RAM (8 GB+ recommended), and a 32 GB drive for umbrelOS. umbrelOS boots from one drive and uses the rest for apps and data.
  • Raspberry Pi 5: boot from an NVMe or USB drive rather than a microSD card.
  • Virtual machines: Proxmox, VirtualBox, VMware, or anything else that supports EFI boot.

A few features depend on your hardware. Storage Manager and FailSafe need two or more internal NVMe or SATA drives, and GPU acceleration needs an NVIDIA, AMD, or Intel GPU on an Intel or AMD machine.

Download and install

Head to umbrel.com/downloads for the latest umbrelOS ISO and images, along with step-by-step installation guides for each platform.

Note

umbrelOS is a standalone operating system that installs directly onto your device. It can't be installed on top of an existing Linux distribution.

Building apps for umbrelOS

If you're interested in building an app for umbrelOS or packaging an existing one, please refer to the Umbrel App Framework documentation.

License

umbrelOS is licensed under the PolyForm Noncommercial 1.0.0 license. TL;DR — You're free to use, fork, modify, and redistribute Umbrel for personal and nonprofit use under the same license. If you're interested in using umbrelOS for commercial purposes, such as selling plug-and-play home servers with umbrelOS, etc — please reach out to us at partner@umbrel.com.

License

umbrel.com

About

An elegant home server OS. Run OpenClaw, store your files and, and do more with over 300 apps in the Umbrel App Store.

Topics

Resources

Contributing

Stars

11.9k stars

Watchers

108 watching

Forks

Releases

Used by

Contributors

Languages