---
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]]
