umbrel README

The project's README from github.com/getumbrel/umbrel. As one markdown file: README.md.

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:

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

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 [email protected].

License

umbrel.com

umbrel (getumbrel/umbrel)

Searching Database…

12.4K ·GitHub
Umbrel
这是什么？Umbrel（umbrelOS）是一款免费、界面精美的家庭服务器操作系统，用于自托管。它可以运行 OpenClaw 等应用、存储你自己的文件，并在你自己的硬件上从 Umbrel 应用商店安装 300 多款应用。
这是要安装在现有 Linux 机器上的应用，还是一个完整的操作系统？umbrelOS 是一个独立的操作系统，直接安装到你的设备上，而不是叠加在现有 Linux 发行版之上的东西。其中的应用以独立打包的服务形式运行，通过 Umbrel 应用商店进行管理。
如何让 umbrelOS 运行起来？从 umbrel.com/downloads 下载 ISO 或设备镜像，然后将其直接烧录并安装到目标硬件上（迷你主机、Raspberry Pi 5 或虚拟机）；网站上为每个平台提供了分步指南。
运行它需要什么硬件？任何 64 位 Intel/AMD 迷你主机、笔记本、台式机、NAS 或服务器，只要具备双核 CPU、至少 4 GB 内存（推荐 8 GB 及以上）和 32 GB 硬盘即可；或者是从 NVMe/USB 启动的 Raspberry Pi 5；又或者是支持 EFI 启动的虚拟机（Proxmox、VirtualBox、VMware 等）。
硬件方面有哪些需要注意的限制？部分功能受硬件限制：Storage Manager 和 FailSafe 需要两块或以上的内置 NVMe/SATA 硬盘，GPU 加速需要 NVIDIA、AMD 或 Intel 显卡，Raspberry Pi 5 必须从 NVMe 或 USB 启动，而不能从 microSD 卡启动。
我可以在树莓派上运行它，还是只能用于 PC 硬件？两者都可以——umbrelOS 支持 Intel/AMD 64 位机器（迷你主机、笔记本、NAS 设备、服务器）、Raspberry Pi 5，以及 Proxmox、VirtualBox 或 VMware 等虚拟机。
我的数据会留在自己的硬件上吗？会的，这正是它的核心所在：既能享受类似云端的便利，又不必放弃对数据的所有权和控制权——所有内容都运行在你拥有的设备上。
Umbrel 真的免费吗，包括转售吗？umbrelOS 在 PolyForm Noncommercial 1.0.0 许可证下对个人和非营利用途免费，允许你使用、分支、修改和再分发；商业用途（例如销售预装服务器）需要直接联系 Umbrel。
umbrelOS 2.0 是什么？它现在稳定了吗？umbrelOS 2.0 目前处于测试版阶段，计划于 2026 年 9 月 22 日发布稳定版；你现在就可以通过全新安装来试用，或在现有的 umbrelOS 1.7.4+ 安装中启用测试版计划。
我能为 Umbrel 应用商店开发自己的应用吗？可以，开发者可以按照 Umbrel App Framework 文档，为 umbrelOS 打包新的或现有的应用。
除了文件存储，我还能在上面运行什么？Umbrel 应用商店中有 300 多款应用，包括 OpenClaw，还内置了对比特币及闪电网络相关应用的支持。
What are similar projects?Self-Hosting-Guide, CasaOS, awesome-raspberry-pi, SparkyFitness, RuView, DnsServer, labtether, core
Which topics is it in?selfhosted, bitcoin, home-automation, self-hosting, raspberry-pi, openclaw, privacy, docker, typescript, self-hosted, cross-platform, linux
Creator
getumbrel
Size
136.7 MB
Stars
12.4K
Updated
CommitSep 22Release2.0.0Sep 22
Age
6y
Commits · 90 Days