Umbrel Prend désormais en charge HomeBridge pour ajouter des produits HomeKit | Guide Détaillé

janvier 25, 2026 Yohan Neris

Découvrez comment utiliser Umbrel pour héberger HomeBridge sur Raspberry Pi, intégrer des périphériques HomeKit non officiels et gagner en contrôle et en flexibilité.

Thank you for reading this post, don't forget to subscribe!

Introduction & Contexte

Intégrer des périphériques HomeKit non officiels (IoT) sans utiliser iCloud, sans dépendre des services propriétaires, et sans limitation de connectivité est un défi fréquent pour les passionnés d’IoT et de Smart Home. Les solutions officielles proposent souvent des contraintes : dépendance à Apple, restriction des périphériques compatibles, et besoin d’un iPhone/iPad pour gérer la base de données (HomeKit Database). L’objectif est de prendre le contrôle total de son infrastructure.

Umbrel est une plateforme open-source basée sur un Raspberry Pi (RPi4 recommandé) qui offre une solution révolutionnaire : héberger HomeBridge de manière autonome, sans dépendre d’iCloud. Elle fournit une centralisation, une résilience, et une compatibilité native avec n’importe quel périphérique HomeKit compatible.

Le guide suivant vous guidera pas à pas à installer et configurer Umbrel sur votre Raspberry Pi, puis à intégrer HomeBridge et à ajouter vos périphériques non officiels. Vous gagnerez une maîtrise totale de votre système HomeKit, sans limitation de connectivité ni dépendance à Apple.

Prérequis Techniques

Matériel Requis

Raspberry Pi (RPi4 + 4Go de RAM minimum recommandé pour une bonne performance avec de nombreux périphériques).
Alimentation USB-C (puissance suffisante – 5V/3A pour le RPi4).
Carte microSD (64GB ou plus, class 10 pour des écritures rapides).
Boîtier pour RPi (pour protection et refroidissement).
Câble Ethernet (optionnel, mais fortement recommandé pour l’initialisation stable).
Clavier, souris, écran (pour l’initialisation via console).
Réseau Local (LAN/Wi-Fi).
Ordinateur pour la configuration (PC/Portable).

Préparation de la Carte MicroSD

Étape 1 : Télécharger l’image Raspberry Pi OS Lite

wget https://downloads.raspberrypi.org/raspios_lite_arm64/images/raspios_lite_arm64-2023-03-16/2023-03-16-raspios-buster-arm64-lite.img.xz

Étape 2 : Flasher avec BalenaEtcher

Étape 3 : Créer fichiers de configuration

wpa_supplicant.conf pour la connexion Wi-Fi (si non câblé).
Fichier ssh vide pour activer le SSH.

Configuration Initiale de la Carte MicroSD

Insérer la carte dans le Raspberry Pi, brancher Ethernet, écran, clavier, souris. Démarrer. Se connecter via SSH (adresse IP par défaut du RPi : 192.168.X.X). Changer le mot de passe pi.

Installation et Configuration d’Umbrel

Étape 1 : Télécharger l’image Umbrel

wget https://umbrel.app/downloads/umbrel-image-raspberry-pi-64bit.img.zip

Étape 2 : Flasher l’image (méthode plus complexe avec dd)

Étape 3 : Configuration Post-Installation

Démarrer l’Umbrel. Accéder au dashboard via navigateur (adresse IP).
Configurer le réseau Wi-Fi.
Activer l’accès SSH via le Portail.
Noter l’adresse IP publique du Portail.

Installation et Configuration de HomeBridge sur Umbrel

Étape 1 : Accès SSH via le Portail

ssh pi@

Étape 2 : Mettre à jour le système

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

Étape 3 : Installer HomeBridge et plugins

sudo apt install homebridge
Installer des plugins spécifiques (camera-ffmpeg, hue, etc.).
Installer HomeBridge Config UI X : npm install -g homebridge-config-ui-x

Étape 4 : Configuration de HomeBridge

Démarrer Config UI X : homebridge-config-ui-x
Créer un utilisateur et un Bridge ID.
Ajouter des périphériques via le mode Manual.

Intégration des Périphériques HomeKit non Officiels

Identification des Périphériques

Connecter le périphérique à un réseau local. Trouver son IP via l’interface web de la caméra ou un scan réseau.

Configuration dans HomeBridge

Dans Config UI X, basculer sur le mode Manual. Sélectionner le plugin approprié (ex: camera-ffmpeg). Entrer les détails (IP, port, credentials).

Validation dans HomeKit

Ouvrir l’application Home et vérifier l’ajout du périphérique.

Configuration du Réseau Local et du Portail

Configuration du DHCP

Dans le dashboard d’Umbrel, activer et configurer le serveur DHCP.

Configuration du Routage

Vérifier l’accès depuis l’extérieur via l’adresse publique et le port configuré.

Configuration du DNS

Assurer la résolution DNS pour le domaine configuré.

Configuration de l’IP Statique

Assigner une IP statique à l’Umbrel via le routeur ou le serveur DHCP d’Umbrel.

Sécurité et Maintenance

Sécurité

Mots de passe forts pour le Portail et HomeBridge.
HTTPS via Let’s Encrypt.
Firewall configuré avec ufw.
Accès SSH restreint.
Mise à jour régulière.

Maintenance

Sauvegardes régulières avec Nextcloud.
Test régulier des périphériques.
Dépannage via les logs de HomeBridge.

Conclusion & Évolution

Résumé des étapes clés pour réussir l’installation. Avantages concrets : contrôle total, intégration de tous les périphériques, résilience, portabilité. Évolution possible : plugins avancés, intégration avec Home Assistant.

Annexes (Optionnelles mais Utiles)

A. Liste des Plugins Recommandés

homebridge-camera-ffmpeg (caméras IP)
homebridge-hue (éclairage Philips)
homebridge-platform-hue (éclairage avec Bridge)
homebridge-smartthings (hub SmartThings)

B. Résolution des Problèmes Connus

Périphérique non détecté : vérifier le port, les credentials, le plugin.
Certificat invalide : configurer HTTPS avec Let’s Encrypt.
Problèmes de port : vérifier le firewall et le NAT.

C. Configuration Avancée

Configuration de l’Horloge (NTP).
Configuration d’un Access Point (AP).

D. Guide de Dépannage

Vérifier l’état du service HomeBridge : sudo systemctl status homebridge.
Vérifier les logs : journalctl -u homebridge -f.

high-phone