Introduction
Umbrel is a home server operating system designed to make self-hosting accessible to everyone. It provides a polished web-based dashboard for installing and managing applications ranging from file storage and media streaming to Bitcoin and Lightning nodes. Built on Docker, it turns any x86 or ARM device into a personal cloud server with one-click app installs.
What Umbrel Does
- Provides a web-based app store with 300+ self-hosted applications
- Manages Docker containers behind the scenes with zero CLI needed
- Handles networking, updates, and backups through a unified UI
- Supports Raspberry Pi, x86 machines, and cloud VMs
- Includes a built-in Tor proxy for remote access without port forwarding
Architecture Overview
Umbrel is built as a container orchestration layer on top of Docker Compose. Each app runs in its own isolated container with a standardized manifest format. The dashboard is a TypeScript web application that communicates with a local API server managing app lifecycle, networking, and storage. An app framework lets community developers package any Docker-based service as an Umbrel app.
Self-Hosting & Configuration
- Install on a Raspberry Pi 4/5 by flashing umbrelOS to an SD card
- Run on any Linux x86 machine using the one-line curl installer
- Configure external access via Tor or a Tailscale/WireGuard VPN
- Set up automatic backups of app data and configuration
- Manage storage by connecting external USB or NAS drives
Key Features
- One-click installs for Nextcloud, Jellyfin, Home Assistant, and more
- Automatic HTTPS with self-signed certificates on the local network
- App sandboxing with per-app network isolation
- Community app store with a simple manifest-based packaging format
- Built-in system monitoring for CPU, RAM, disk, and network usage
Comparison with Similar Tools
- CasaOS — similar concept but smaller app ecosystem
- TrueNAS — focused on storage; heavier resource requirements
- YunoHost — Debian-based; more complex initial setup
- Tipi (Runtipi) — lighter alternative with fewer apps available
FAQ
Q: What hardware does Umbrel support? A: Raspberry Pi 4/5, any x86_64 Linux machine, and most cloud VMs. Minimum 2 GB RAM and 32 GB storage recommended.
Q: Can I access my Umbrel server remotely? A: Yes. Umbrel includes built-in Tor support for remote access. You can also set up Tailscale or a VPN for faster connections.
Q: Is Umbrel free? A: Yes. umbrelOS and all core features are free. Some third-party apps in the store may have their own licensing.
Q: How do I migrate from another self-hosting platform? A: Install the same apps on Umbrel and migrate data by copying Docker volumes or using each app's built-in import tools.