UniFi Protect ne propose pas d'intégration HomeKit native. Homebridge peut combler ce manque grâce au plugin Homebridge UniFi Protect : les caméras, sonnettes et capteurs compatibles apparaissent alors dans l'app Maison et peuvent participer aux automatisations Apple.
Cette intégration communautaire fonctionne encore avec les versions officielles actuelles de Protect, mais elle demande un serveur Homebridge disponible en permanence et un compte local dédié sur la console UniFi.
Mise à jour du 14 septembre 2026 : le tutoriel a été repris pour UniFi Protect 6 ou plus récent, avec la création du compte local, les droits réellement demandés par le plugin et les précautions de sécurité.
En bref : ce qu'il faut avant de commencer
Il faut une console exécutant UniFi Protect, des caméras déjà fonctionnelles dans l'application officielle, un serveur Homebridge et le plugin vérifié homebridge-unifi-protect. Le plugin prend actuellement en charge les versions officielles de Protect 6 ou plus récentes. Les versions bêta, Early Access et Release Candidate ne sont pas supportées par le projet.
Homebridge reste une passerelle non officielle. Une mise à jour d'UniFi OS, de Protect, de Homebridge ou du plugin peut demander une adaptation. Conservez toujours l'application Protect comme accès principal et évitez de dépendre de HomeKit pour une fonction critique de sécurité.
Installer Homebridge sur un appareil stable
Homebridge peut fonctionner sur un Raspberry Pi, un Mac, un NAS ou une machine virtuelle. Le meilleur hôte n'est pas le plus puissant, mais celui qui reste allumé, reçoit des mises à jour et dispose d'une connexion réseau stable. Une caméra qui dépend d'un ordinateur portable fermé ne sera pas disponible au bon moment.
Installez Homebridge et son interface Config UI selon la documentation de votre plateforme. Avant d'ajouter Protect, vérifiez que l'interface Homebridge est accessible sur le réseau local et que le pont principal apparaît correctement dans Maison. Mon tour complet de la maison HomeKit montre le rôle que cette passerelle peut prendre dans une installation plus large.
Installer le plugin Homebridge UniFi Protect
Dans l'onglet Extensions de Homebridge, recherchez homebridge-unifi-protect. Choisissez le plugin vérifié dont le dépôt officiel est maintenu par hjdhjd. La documentation du projet contient les versions requises, le journal des changements et les options avancées.
Après l'installation, ouvrez la configuration du plugin. Il demandera l'adresse IP ou le nom d'hôte de la console Protect, ainsi qu'un nom d'utilisateur et un mot de passe. Ne saisissez pas les identifiants du compte UI.com principal et ne recyclez pas un mot de passe utilisé ailleurs.
Créer un compte UniFi local dédié
Dans les réglages d'UniFi OS de la console Protect, ajoutez un administrateur puis activez l'accès local uniquement. Donnez-lui un nom explicite, par exemple homebridge-protect, et un mot de passe long généré pour cet usage.
La documentation actuelle du plugin indique qu'un rôle Full Management est nécessaire pour toutes ses fonctions, même si un fonctionnement plus limité peut rester possible avec moins de droits. Cette exigence rend le compte dédié encore plus important. Restreignez-le à la console concernée, à un accès local et aux rôles indispensables. Ne lui donnez pas accès à d'autres systèmes par commodité.
Renseigner la console dans Homebridge
Entrez l'adresse locale stable de la console, le compte dédié et son mot de passe. Une réservation DHCP évite qu'un changement d'adresse casse la connexion. Enregistrez la configuration du plugin puis redémarrez Homebridge lorsque l'interface le demande.
Consultez ensuite les journaux. Une authentification réussie doit être suivie de la découverte des appareils Protect. Une erreur de connexion pointe généralement vers l'adresse, le certificat local, le mot de passe ou les droits. Une erreur de flux peut venir de FFmpeg, du codec audio ou d'une plateforme Homebridge non prise en charge.
Ajouter les caméras dans Maison
Selon la configuration et la version du plugin, les accessoires peuvent apparaître via le pont Homebridge principal ou un pont enfant. Scannez le code HomeKit indiqué dans l'interface Homebridge si Maison demande l'ajout d'un nouveau pont. N'ajoutez pas plusieurs fois le même pont pour résoudre un simple délai de découverte.
Les caméras détectées apparaissent avec leur flux et un capteur de mouvement. Les ajouts et suppressions réalisés dans Protect sont normalement détectés par le plugin. Renommez les pièces et accessoires dans Maison sans changer au hasard les identifiants techniques du plugin, car HomeKit pourrait alors considérer l'appareil comme nouveau.
HomeKit Secure Video et enregistrement Protect
Le plugin propose une prise en charge de HomeKit Secure Video selon les appareils et la configuration. Cela n'annule pas l'enregistrement UniFi Protect : les deux systèmes ont leur propre stockage, leurs règles de détection et leurs limites. Vérifiez séparément la chronologie Protect et l'historique HomeKit avant de compter sur l'un ou l'autre.
Le transcodage vidéo peut solliciter fortement l'hôte Homebridge. Le plugin cherche à utiliser les flux adaptés et à éviter les conversions inutiles, mais une machine ancienne ou plusieurs consultations simultanées peuvent provoquer un démarrage lent. Commencez avec les réglages automatiques avant de modifier résolution, débit ou audio.
Notifications, mouvements et automatisations
Chaque caméra peut exposer un capteur de mouvement. Maison peut utiliser cet événement pour une notification, une lumière ou une scène. Il faut éviter de doubler toutes les alertes Protect et HomeKit : choisissez l'application la plus utile selon le contexte et désactivez les notifications redondantes.
Une détection de mouvement n'est pas une alarme certifiée. Les ombres, insectes, phares ou changements météo peuvent créer de faux événements. Testez les automatisations la nuit et en journée avant de leur associer une action importante.
Sécurité et maintenance
Placez Homebridge et la console Protect sur un réseau maîtrisé. N'exposez pas directement leurs interfaces d'administration sur Internet. Pour administrer le réseau à distance, utilisez un accès VPN actuel plutôt qu'une redirection de port. Mon guide sur la connexion VPN à une UniFi Dream Machine explique les options Teleport et WireGuard qui remplacent l'ancien tutoriel L2TP.
Avant une mise à jour majeure, lisez le journal des changements du plugin et gardez une sauvegarde de Homebridge. Restez sur les versions officielles d'UniFi OS et Protect si la continuité HomeKit compte. Une panne de Homebridge ne doit jamais supprimer l'accès aux enregistrements dans Protect.
Une intégration efficace, mais non native
Une fois installé, le résultat est très agréable : les flux Protect s'ouvrent dans Maison, les capteurs deviennent disponibles et l'écosystème Apple peut participer aux automatisations. Il faut simplement conserver la bonne frontière. Protect reste le système de vidéosurveillance, Homebridge traduit ses appareils pour HomeKit, et Maison fournit une interface supplémentaire.