mrkeyoor.com_
Sat 26 Sept 16:07 UTC
Self-Hostedevaluationupdated 26 Sept 2026

umbrel review

umbrelOS is a standalone home-server operating system with a browser interface and an app store. It turns a supported PC, Raspberry Pi 5 or virtual machine into a box for files, photos, apps and virtual machines that you control.

Verdict

Our npm run added 0 packages and exposed no generic build or test target, so cloning the 89.8 MB source tree is a poor trial of umbrelOS itself. Use the published 2.0 image on spare hardware or an EFI virtual machine if you want a polished home-server appliance and accept a noncommercial license. Wait for early 2.0 issues to settle if backup restoration, Windows VM topology or multi-drive storage is central to your plan.

We ran it

Lab card: what happened when we ran umbrelScreenshot of umbrel (umbrel.com)
Install✓ · 2s0 packages · 161 MB
Buildn/ano build script
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo2199 files~299,351 lines of source · 89.8 MB · 3 CI workflows

Answers from our run

Does umbrel build from source?

Dependencies installed in 2 seconds (0 packages), and the project has no separate build step. We cloned commit 11e7f5b into a clean Debian container with 3 CPUs and no project-specific setup.

Does umbrel have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does umbrel have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use umbrel?

Anyone who needs to install the dashboard on an existing Linux server: the README says umbrelOS is a standalone OS and cannot be installed over a current distribution.

What are the alternatives to umbrel?

CasaOS, YunoHost, Runtipi. Our npm run added 0 packages and exposed no generic build or test target, so cloning the 89.

Setup3/5Image install is guided; it needs a dedicated device or VM
Docs3/5Clear hardware limits, but README still calls released 2.0 a beta
Community5/512,073 stars and active issue reports after the 2.0 release
Maturity3/5Established project, while the large 2.0 release is four days old

Who it’s for

Home users who want one graphical place to run self-hosted apps, files and photos.
People willing to dedicate a supported x86 machine, Raspberry Pi 5 or virtual machine to a server OS.
Households that can use umbrelOS 2.0's separate accounts, private folders and shared apps.
AI-agent users who want an MCP server with per-agent tokens and permission controls.

Who it’s NOT for

Anyone who needs to install the dashboard on an existing Linux server: the README says umbrelOS is a standalone OS and cannot be installed over a current distribution.
Businesses planning to sell Umbrel-based appliances without a separate agreement: PolyForm Noncommercial permits personal and nonprofit use, while the README directs commercial users to Umbrel.
Raspberry Pi 5 owners who only have a microSD card: the supported-device notes require booting from NVMe or USB storage.
Storage or VM operators who need every 2.0 edge case settled: current reports describe a failed 1.x SMB backup restore and a Windows guest seeing only 2 of 6 assigned virtual CPUs.

Setup reality

Our root-level npm install succeeded in 2 seconds, added 0 packages and left 161 MB on disk. There was no generic build script or test script, so both steps were skipped; npm audit found 0 known vulnerabilities. Those numbers describe the repository root, not a booted umbrelOS machine.

Real installation uses an OS image for a supported x86 device, Raspberry Pi 5 or EFI virtual machine. The minimum listed x86 hardware is a dual-core CPU, 4 GB RAM and a 32 GB system drive; 8 GB or more is recommended.

The repository's development command builds and starts a privileged Docker environment with systemd. Production features add their own requirements: multiple internal drives for Storage Manager and FailSafe, a supported GPU for acceleration and per-agent tokens for MCP access.

umbrelOS 2.0 turns a spare machine into an appliance

umbrelOS is for people who want home-server software to feel like a product. You install an image, open a browser and manage apps, files, photos, storage and virtual machines from one interface. Version 2.0 adds separate user accounts, a Photos app, iPhone and Mac clients, Machines for guest operating systems and an MCP server for AI agents. The app store lists more than 300 apps.

That convenience comes from owning the whole machine. The README supports most 64-bit Intel and AMD systems, Raspberry Pi 5 and EFI-capable virtual machines. It explicitly says umbrelOS cannot be installed on top of an existing Linux distribution. Anyone with a carefully configured Debian host should treat migration as an operating-system decision, not as adding another dashboard.

The root npm command only checks a thin wrapper

The repository looks like a TypeScript monorepo, yet its root package has no dependencies. Our npm install added 0 packages in 2 seconds and left 161 MB on disk. Root scripts hand work to project tools: the development command manages an umbrelOS environment, while remote scripts handle build and test jobs elsewhere. Running npm at the top level does not produce an installable server.

The real developer path is much heavier than that 2-second result suggests. The umbrel-dev script builds a Docker image, starts a privileged container and runs systemd inside it. It mounts the checkout read-only, puts generated files and dependencies in writable storage and gives the instance its own data volume. Linux Docker is the straightforward host; the help text also discusses OrbStack on macOS and WSL 2 on Windows.

What happened when we ran it

Our sandbox cloned commit 11e7f5b, a repository with 2,199 files, about 299,351 lines of source and an 89.8 MB checkout. The npm install succeeded in 2 seconds with 0 packages added. Disk use was 161 MB after that step, and npm audit reported 0 known vulnerabilities.

No generic build script or test script was available, so the lab skipped both steps. The repository has 3 CI workflow files, no Dockerfile at its root and no root tests directory. Those facts do not say the released image works or fails. They say the standard npm harness cannot exercise an operating system whose own scripts expect image builders, privileged containers and package-specific commands.

A useful trial therefore starts with the published ISO or image inside an EFI virtual machine or on hardware you can dedicate. Our run did not boot umbrelOS, install an app, restore a backup or test its browser interface. Treat the lab's clean 2-second install as a source-layout finding, not a product acceptance test.

Hardware choices decide which 2.0 features you receive

The x86 baseline is a dual-core CPU, 4 GB of RAM and a 32 GB drive for umbrelOS; the README recommends at least 8 GB of RAM. A Raspberry Pi 5 must boot from an NVMe or USB drive instead of microSD. Storage Manager and FailSafe require 2 or more internal NVMe or SATA drives, while GPU acceleration requires supported NVIDIA, AMD or Intel hardware on an x86 machine.

This is a good kind of specificity because it prevents an attractive settings screen from becoming a hardware promise. A small one-drive mini PC can still run apps and store data, but it cannot gain drive redundancy through software alone. Raspberry Pi builders should also read current issue 2217, which reports that the Pi image lacks ZFS even on boards with multiple NVMe slots; pull request 2216 proposes adding it.

Fresh 2.0 reports make backup testing mandatory

Umbrel released version 2.0.0 on September 22, 2026. GitHub recorded the last push that day, 12,073 stars and 478 combined open issues and pull requests. The README still says 2.0 is in beta with a stable release planned for September 22, even though the release page now carries the stable tag. That mismatch is small, but it shows the documentation did not move in lockstep with launch.

Several reports filed after release affect decisions rather than cosmetics. Issue 2245 describes a roughly 100 GB backup from umbrelOS 1.x that was recognized but restored neither apps nor files. Issue 2246 reports a Windows 11 guest configured for 6 virtual CPUs seeing only 2 because of its generated topology. These are user reports, not findings from our sandbox, but both deserve a reproduction before a migration.

Version 2.0 also adds automatic HTTPS, cloud downloads, multiple users and per-agent MCP tokens with revocable permissions. Google Drive is described as coming later, while Dropbox, OneDrive, iCloud Drive, Nextcloud, ownCloud and WebDAV are listed now. Scope your evaluation around the exact feature you need. A Photos test says little about backup recovery, and a working app container says little about VM networking.

The noncommercial license changes who should adopt it

Personal and nonprofit use is the easy case. The PolyForm Noncommercial 1.0.0 license allows use, modification and redistribution for permitted noncommercial purposes. The README tells anyone selling plug-and-play servers or pursuing another commercial use to contact Umbrel. This is materially different from choosing a permissive server project for an appliance business.

For a household, umbrelOS 2.0 is appealing because it packages many chores into one coherent interface. The decision still deserves a spare machine, a restore drill and a look at the feature-specific issue queue. Start with a VM, test the 32 GB system-drive layout and your backup path, then move data only after recovery works on the hardware you intend to keep.

Alternatives

ProjectWhat it isPick it when
CasaOSA browser-managed personal cloud layer centered on Docker apps.pick this instead when you want a lighter app dashboard on a Linux host rather than replacing the host with a dedicated OS.
YunoHostA Debian-based server system for hosting web services and managing users.pick this instead when domains, public web apps and server administration matter more than a home-media appliance interface.
RuntipiA self-hosted app platform with a web dashboard and curated app catalog.pick this instead when the app-store experience is the main goal and you prefer a Docker-centered server stack.

What people are saying

  1. [github-trending] getumbrel/umbrel

Sources

  1. umbrelOS repository and installation README
  2. umbrelOS 2.0 release
  3. PolyForm Noncommercial license
  4. SMB backup restore report
  5. Windows virtual CPU topology report
  6. Raspberry Pi ZFS report

More self-hosted reviews

reth · openbao · NewPipe · CFBox · wg-easy · probo · the whole board →