umbrelOS: a self-hosting OS that installs on bare metal, not on top of Linux
An elegant home server OS. Run OpenClaw, store your files and, and do more with over 300 apps in the Umbrel App Store.
At a glance
- What is it?
- umbrelOS is a standalone home server operating system from getumbrel, distributed as a free image for Intel and AMD machines, Raspberry Pi 5 and VMs, with umbrelOS 2.0 now released and a PolyForm Noncommercial licence. It is aimed at people who want app-store convenience without renting someone else's computer.
- Who is it for?
- Adopt umbrelOS if you want a self-hosted app catalogue on a dedicated Intel or AMD box, a Raspberry Pi 5 booting from NVMe or USB, or a Proxmox VM, and you accept the PolyForm Noncommercial 1.0.0 terms for personal or nonprofit use.
- Can I use it commercially?
- Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
- Is it still maintained?
- Yes. The repository last received commits 12 days ago.
- What is it written in?
- Mainly TypeScript, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- getumbrel/umbrel12,574 ★ · +631
| Repository | 2026-09-13 | 2026-11-15 |
|---|---|---|
| getumbrel/umbrel | 11.9k | 12.6k |
631 Stars in the last 63 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
What problem umbrelOS solves, and for whom
The README frames the goal in one sentence: enjoy the convenience of the cloud without giving up ownership and control of your data. In practice that means the project ships an operating system rather than a package you install into Debian or Ubuntu. umbrelOS boots the machine itself, and the app catalogue lives on top of that. The audience is the person who wants one of the 300-plus apps named in the repository description, but does not want to hand-roll Docker Compose files, reverse proxies and TLS certificates to get there. The repository description also points at OpenClaw and file storage as headline uses. If your job is running a handful of self-hosted services for a household or a small group, this is the target case. If your job is running Kubernetes, it is not.
Standalone OS, not a layer on your existing Linux
The single most consequential design decision is stated plainly in the README: umbrelOS is a standalone operating system that installs directly onto your device, and it cannot be installed on top of an existing Linux distribution. That rules out the pattern many self-hosters expect, where you keep a familiar distro and add a management layer. Here the OS is the product. The README also states that the image you install on your own hardware is the same umbrelOS that ships on Umbrel Home and Umbrel Pro, with the same features and the same updates. That is a meaningful commitment: there is no separate community edition with features stripped out, at least according to the documentation. The trade-off is that you are adopting an entire platform, including its update cadence, rather than a tool you can remove from an otherwise standard server.
Hardware boundaries and the features that need more than one disk
The README lists the supported targets: most 64-bit Intel and AMD mini PCs, laptops, desktops, NAS boxes and servers; Raspberry Pi 5; and virtual machines on Proxmox, VirtualBox, VMware or anything else that supports EFI boot. Minimum requirements for Intel and AMD are a dual-core CPU, 4 GB RAM (8 GB or more recommended) and a 32 GB drive for umbrelOS itself. The layout detail matters: umbrelOS boots from one drive and uses the rest for apps and data. On Raspberry Pi 5 the README says to boot from an NVMe or USB drive rather than a microSD card, which is consistent with the known endurance problems of SD cards under sustained writes. Two features are hardware-gated. 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. If you have a single-disk mini PC, those two features are simply unavailable to you.
Getting it running: downloads, VM images and the beta toggle
Installation starts at umbrel.com/downloads, which the README says hosts the latest ISO and images plus step-by-step guides per platform. There is no apt package and no install script for an existing system. umbrelOS 2.0 is now out, with 2.0.1 published on 2026-11-01, and the README tells existing users to update from Settings > Software update. App packaging is a separate repository: the README points developers to the Umbrel App Framework documentation in getumbrel/umbrel-apps rather than describing the manifest format here.
The licence is the constraint most people will miss
The repository metadata reports the licence as NOASSERTION, and the README resolves that ambiguity: umbrelOS is licensed under PolyForm Noncommercial 1.0.0. The README's own summary says you are free to use, fork, modify and redistribute Umbrel for personal and nonprofit use under the same licence, and that commercial use, such as selling plug-and-play home servers with umbrelOS, requires contacting [email protected]. This is not an OSI-approved open source licence, and the noncommercial restriction is the reason. For a homelab or a nonprofit deployment the terms as described are permissive. For a managed service provider, a reseller, or anyone building a product on top of the OS, the README directs you to a partner conversation instead of granting rights. That is a business decision embedded in a licence file, and it should be read in LICENSE.md rather than inferred from the README's TL;DR. Nothing here is legal advice; the point is that the licence text, not the summary, governs.
Where umbrelOS is the wrong tool
Three cases stand out. First, you already run a tuned Linux server with your own storage layout, firewall rules and backup jobs. The README forecloses installing umbrelOS on top of that distribution, so adopting it means rebuilding the machine, not extending it. Second, you are on a single-drive box and your reason for looking at umbrelOS is storage pooling or redundancy. Storage Manager and FailSafe both require two or more internal NVMe or SATA drives, so on one disk those features do not exist for you. Third, you need commercial redistribution. The PolyForm Noncommercial terms block the reseller path without a separate agreement.
The alternative: a general-purpose distro with your own container stack
The obvious comparison is Debian or Ubuntu plus Docker Compose, and the difference is where the abstraction sits. With a plain distro you own the bootloader, the upgrade path, the firewall and the volume mounts, and you install each service from its upstream image. You get portability: any container you define can move to another host unchanged, and nothing in your stack assumes an app-store manifest. umbrelOS inverts that. The OS boots the device, the app catalogue is curated, and updates arrive through the platform rather than through your own compose files. The cost is coupling. You cannot drop umbrelOS into an existing Linux install, the hardware gates on Storage Manager, FailSafe and GPU acceleration are fixed by the OS rather than by what you install, and the licence restricts commercial redistribution in a way that the Debian and Docker licences do not. Choose the distro route when you want to keep control of the boot and update layers, and umbrelOS when you want the appliance experience on hardware you own.
Maintenance and upgrade cost
umbrelOS updates as a whole system, and the README says the self-installed image receives the same features and the same updates as the Umbrel Home and Umbrel Pro hardware. umbrelOS 2.0 was released on 2026-09-22 and 2.0.1 on 2026-11-01, and existing installs update from Settings > Software update. On the build side, the app framework documentation lives in a separate repository, so maintaining a private app means tracking that repository's manifest format rather than a format defined in this one. The README does not mention migration tooling between major versions or backup guidance for the OS volume itself.
Editorial conclusion
Adopt umbrelOS if you want a self-hosted app catalogue on a dedicated Intel or AMD box, a Raspberry Pi 5 booting from NVMe or USB, or a Proxmox VM, and you accept the PolyForm Noncommercial 1.0.0 terms for personal or nonprofit use. Do not adopt it if you need to layer it onto an existing Linux install (the README states it cannot be installed on top of one), if you plan to resell hardware with it preinstalled without contacting [email protected], or if you depend on Storage Manager or FailSafe and have only one internal drive. Before committing, confirm your machine meets the dual-core, 4 GB RAM and 32 GB boot-drive minimums, note that umbrelOS 2.0 shipped as a release on September 22, 2026, with 2.0.1 following on November 1, 2026, and read LICENSE.md yourself rather than relying on the README's TL;DR.
Frequently asked questions
What is an Umbrel?
Umbrel builds umbrelOS, which its README calls a home server OS for self-hosting. It is free to download for Intel or AMD machines, a Raspberry Pi 5, or a virtual machine, and it installs as a standalone operating system on the device rather than on top of an existing Linux distribution.
Who is the owner of Umbrel?
The repository sits under the getumbrel organization on GitHub and the project site is umbrel.com, with a community forum at community.umbrel.com. The project also sells Umbrel Pro and Umbrel Home hardware while stating the free image is the same umbrelOS, with the same features and the same updates, and it routes commercial licensing enquiries to [email protected].
Is Umbrel OS free?
For personal and nonprofit use it is free, under the PolyForm Noncommercial 1.0.0 licence, which permits use, forking, modification, and redistribution under the same license. Commercial use, including selling plug and play home servers with umbrelOS, requires contacting the project at [email protected], and the repository licence field reads NOASSERTION.
how to install umbrel os
Download the latest umbrelOS ISO and images from umbrel.com/downloads and follow the guides for each platform. umbrelOS installs directly onto the device and cannot be installed on top of an existing Linux distribution, while an existing install updates from Settings > Software update.
umbrel vs start9
The repository makes no comparison with other self-hosting systems. What it states about itself is the scope: a standalone home server OS, supported on 64-bit Intel and AMD machines, Raspberry Pi 5, and EFI capable virtual machines, with over 300 apps in the Umbrel App Store.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/getumbrel-umbrel)Star history chart for your README
[](https://hysenlabs.com/projects/getumbrel-umbrel)Was this useful?