117 lines
5.6 KiB
Markdown
117 lines
5.6 KiB
Markdown
---
|
|
title: umbrelOS
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, deployment, os, app-store, linux, home-server]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Deployment, https://github.com/getumbrel/umbrel]
|
|
---
|
|
|
|
# 🚀 umbrelOS
|
|
|
|
> **L'OS complet pour self-hosting** — distribution Linux + app store grand public, conçu pour transformer n'importe quel mini-PC en home server clé en main (bitcoin node, Nextcloud, Plex, etc.).
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [umbrel.com](https://umbrel.com/) |
|
|
| **GitHub** | [getumbrel/umbrel](https://github.com/getumbrel/umbrel) |
|
|
| **License** | PolyForm Noncommercial / UmbrelOS |
|
|
| **Langage** | Shell / TypeScript / Docker |
|
|
| **Étoiles GitHub** | 11 370 ⭐ |
|
|
| **Catégorie** | [[cat-deployment\|Deployment & PaaS]] |
|
|
|
|
## 📝 Description
|
|
|
|
**umbrelOS** (anciennement "Umbrel") est une **distribution Linux complète** pensée pour le **self-hosting familial**. Sa philosophie : **zéro ligne de commande, zéro fichier yaml, zéro DevOps** — on branche un Raspberry Pi ou un mini-PC, on boot sur umbrelOS, on accède à une **UI web élégante** (style "macOS"), et on installe des apps en un clic depuis un **app store** de plus de 200 applications.
|
|
|
|
L'écosystème a commencé autour du **Bitcoin node** (Umbrel a été créé en 2020 par un contributeur Bitcoin Core), puis s'est élargi à : **Nextcloud** (cloud personnel), **Plex/Jellyfin** (média), **Home Assistant** (domotique), **Pi-hole** (DNS), **Syncthing** (sync), **Immich** (photos), **Vaultwarden** (mots de passe), **Gitea** (Git), etc. Chaque app tourne dans un **conteneur Docker** isolé, gérée par un **manager** interne.
|
|
|
|
**umbrelOS** en tant que système inclut : un **installateur clé en main** (sur Raspberry Pi 4/5, mini-PC x86, VM), un **dashboard** web unifié, un **store** d'apps communautaires, un **reverse proxy** automatique (Traefik embarqué), un **système de mises à jour** OTA, et un **store de hardware préconfiguré** (Umbrel Home, U3A). La version **umbrelOS Community** est gratuite ; la version **Home** est payante (hardware + features).
|
|
|
|
**Public cible** : **particuliers** qui veulent un "NAS moderne" sans administrer Linux, **familles** qui centralisent cloud/média/domotique, **homelabbers** qui débutent. Pour un app store plus technique, voir [[app-runtipi]] ; pour un PaaS orienté dev, [[app-coolify]] / [[app-dokploy]].
|
|
|
|
## 🚀 Installation
|
|
|
|
### Installation officielle (sur hardware dédié)
|
|
|
|
```bash
|
|
# Télécharger l'image umbrelOS depuis getumbrel.com
|
|
# Flasher sur SSD/USB avec Raspberry Pi Imager ou balenaEtcher
|
|
# Boot, accéder à umbrel.local depuis un navigateur
|
|
# 1er lancement : créer un compte local
|
|
```
|
|
|
|
### Via Docker (test/VM — pour évaluer)
|
|
|
|
```yaml
|
|
# docker-compose.yml — umbrel Community en mode conteneur
|
|
services:
|
|
umbrel:
|
|
image: ghcr.io/getumbrel/umbrel:latest
|
|
container_name: umbrel
|
|
restart: unless-stopped
|
|
ports:
|
|
- "80:80"
|
|
- "443:443"
|
|
volumes:
|
|
- ./data:/home/umbrel/umbrel
|
|
- /var/run/docker.sock:/var/run/docker.sock:ro
|
|
privileged: true
|
|
```
|
|
|
|
> ⚠️ **Mode Docker limité** — umbrelOS brille vraiment en **OS natif** (Raspberry Pi, U3A, VM). Le mode conteneur est utile pour évaluer, pas pour de la prod.
|
|
|
|
## ⚙️ Configuration
|
|
|
|
1. **Booter sur l'image umbrelOS** — l'installateur formate le disque, configure le réseau, génère un mDNS (`umbrel.local`)
|
|
2. **Créer un compte local** depuis l'UI web (premier accès)
|
|
3. **Configurer le stockage** : onglet Settings → Storage → ajouter un disque externe (HDD/SSD USB)
|
|
4. **Installer des apps** : App Store → rechercher → "Install". Chaque app a son sous-domaine (`nextcloud.umbrel.local`)
|
|
5. **Configurer un domaine personnalisé** : Settings → Advanced → Domain (ex : `cloud.example.com`)
|
|
6. **Activer Tor** : Settings → Advanced → Tor → chaque app est aussi accessible en `.onion`
|
|
7. **Mettre à jour** : OTA automatique, ou manuellement depuis Settings → Update
|
|
8. **Monitoring** : dashboard intégré affiche CPU, RAM, stockage, état des conteneurs
|
|
|
|
## 🔗 Alternatives
|
|
|
|
- **Runtipi** — app store similaire, plus technique, sans OS dédié
|
|
- **CasaOS** — autre OS self-hosted, UI ZimaBoard, app store moins riche
|
|
- **Yunohost** — distribution Debian + apps, plus ancien, plus orienté "hébergement citoyen"
|
|
- **Synology DSM** — NAS propriétaire, UI proche, plus cher
|
|
- **OpenMediaVault** — NAS Linux pur, sans app store
|
|
- **Coolify / Dokploy** — PaaS orienté développeurs (pas user-friendly)
|
|
- **Home Assistant OS** — dédié domotique, plus restreint
|
|
|
|
## 🔒 Sécurité
|
|
|
|
- **Compte local obligatoire** : pas d'accès anonyme, **utiliser un mot de passe fort**
|
|
- **Activer 2FA** sur le compte umbrel
|
|
- **Tor activé** par défaut pour les apps sensibles (option désactivable)
|
|
- **Mises à jour OTA** : ne pas les différer (correctifs de sécurité)
|
|
- **Backup du répertoire** `./umbrel` (apps, données, configs)
|
|
- **Reverse proxy** : umbrel expose 80/443 — ajouter un Cloudflare Tunnel ou VPN si exposition WAN
|
|
- **SSH désactivé** par défaut sur umbrelOS (à n'activer que pour debug)
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Documentation officielle](https://docs.umbrel.com/)
|
|
- [Dépôt GitHub getumbrel/umbrel](https://github.com/getumbrel/umbrel)
|
|
- [App Store Umbrel](https://apps.umbrel.com/)
|
|
- [Communauté Umbrel](https://community.umbrel.com/)
|
|
- [Umbrel Home (hardware)](https://umbrel.com/umbrel-home)
|
|
|
|
## 🔗 Pages Liées
|
|
|
|
- [[cat-deployment]]
|
|
- [[app-runtipi]]
|
|
- [[app-coolify]]
|
|
- [[app-dokploy]]
|
|
- [[app-yacht]]
|
|
- [[cat-docker]]
|
|
- [[securisation-home-lab]]
|
|
- [[recettes-docker-compose]]
|