Home Assistant Bbox : intégration et configuration

Ajouter Bbox-Mag à vos sources préférées

Home Assistant Bbox : oui, Home Assistant sait dialoguer avec votre Bbox grâce à une intégration communautaire à installer via HACS. Elle remonte le trafic, l'état de la connexion et les appareils présents, et elle pilote le Wi-Fi. L'intégration officielle, elle, reste très limitée.

Home Assistant Bbox : quel rôle pour la box ?

En effet la Bbox ne remplace pas Home Assistant, elle lui fournit le réseau. Home Assistant tourne chez vous, sur un Raspberry Pi, un boîtier dédié ou un mini-PC, et il communique avec vos objets par votre réseau local. Ainsi la Bbox apporte la connexion, le Wi-Fi et l'accès à internet.

En revanche les deux peuvent aussi dialoguer. Home Assistant lit alors des informations sur la box, comme les appareils connectés ou le débit, et il peut agir sur certains réglages. Pour installer le logiciel, notre guide débuter avec Home Assistant détaille le matériel et les premières étapes.

L'intégration officielle « Bbox » de Home Assistant

Par ailleurs Home Assistant propose une intégration nommée Bbox depuis ses premières versions. Elle détecte les appareils connectés à la box pour la présence, et elle fournit des capteurs : débit maximal et débit courant en réception et en émission, durée depuis le dernier démarrage et nombre de redémarrages.

Toutefois cette intégration est classée « legacy » et se configure par le fichier YAML. La documentation cite comme seul modèle testé un Sagem F@st 5330b, un matériel ancien, et précise que la box doit se trouver sur le même réseau local que Home Assistant. Rien ne garantit donc son fonctionnement sur une Bbox récente. Elle convient donc surtout à un usage simple.

L'intégration communautaire hass-bbox2 pour la Bbox

D'abord un contributeur indépendant publie hass-bbox2, un composant personnalisé pour la Bbox. Il s'installe par HACS, le magasin communautaire de Home Assistant, et se configure depuis l'interface. Le dépôt indique une prise en charge des routeurs sous Bbox OS, toutes versions confondues, sans liste de modèles. Nous n'avons pas pu confirmer son fonctionnement sur chaque Bbox récente, comme la Bbox WiFi 7.

Précisons toutefois que ce composant n'est pas édité par Bouygues Telecom. Son fonctionnement peut donc évoluer avec les mises à jour de la box ou de Home Assistant.

Installer Home Assistant Bbox pas à pas

D'abord définissez un mot de passe pour l'administration de la box, car l'intégration en a besoin pour se connecter. Ensuite ouvrez l'interface de votre box sur mabbox.bytel.fr pour vérifier que vous y accédez bien.

Puis dans Home Assistant ajoutez le dépôt hass-bbox2 dans HACS, catégorie intégration, et redémarrez. Enfin allez dans Paramètres, Appareils et services, ajoutez l'intégration Bbox et saisissez le mot de passe. Vous pouvez ensuite activer l'option qui suit les appareils filaires.

Fiabilité et sécurité du composant

Le composant est un projet libre, géré par un seul développeur. Il publie des versions régulières et des correctifs, mais il compte peu d'utilisateurs et plusieurs demandes restent ouvertes. Parmi elles figurent des problèmes d'interrupteurs Wi-Fi et un avertissement de compatibilité avec une évolution de Home Assistant. Aucun avis de sécurité n'est publié à ce jour.

Côté sécurité, trois précautions s'imposent. D'abord un composant installé par HACS s'exécute avec les droits de Home Assistant, sans contrôle de l'équipe officielle. Ensuite vous lui confiez le mot de passe d'administration de votre box. Enfin la connexion par adresse IP désactive la vérification du certificat, ce qui reste acceptable sur un réseau domestique de confiance seulement.

Les bons réglages réseau avec une Bbox

Pour une configuration Home Assistant Bbox fiable, Home Assistant et la box doivent se trouver sur le même réseau local. En effet l'intégration lit les informations en local et ne passe pas par internet. De plus un branchement en filaire reste le plus stable pour le boîtier qui héberge Home Assistant.

Pensez aussi à lui donner une adresse fixe, afin qu'elle ne change pas après un redémarrage. Ainsi vous pouvez la définir dans Home Assistant ou réserver l'adresse dans les réglages de la box. Vérifiez le menu exact dans l'interface de votre box, car il peut varier selon le modèle.

Pour joindre Home Assistant hors de chez vous, il existe un service d'accès à distance. Home Assistant Cloud devient Home Assistant Link en décembre, comme l'explique notre article sur Home Assistant 2026.10.

Quelques idées d'automatisations avec la Bbox

Voici donc trois usages possibles pour votre Home Assistant Bbox. D'abord une notification quand l'état de la connexion indique une coupure. Ensuite la coupure du Wi-Fi invité la nuit, par un interrupteur. Enfin un scénario de présence qui éteint le chauffage quand tous les téléphones ont quitté le réseau, en tenant compte du délai d'une à deux minutes avant le passage en « absent ».

Par ailleurs pour construire ces scénarios, notre comparatif des box domotique et alternatives à Home Assistant aide aussi à choisir le bon contrôleur.

À retenir

• Deux intégrations : l'officielle (YAML, capteurs de débit et présence) et hass-bbox2 (HACS, état WAN, Wi-Fi, boutons).
• Prérequis : un mot de passe d'administration de la box et le même réseau local.
• Limite : hass-bbox2 est un composant indépendant, non édité par Bouygues Telecom, sans liste de modèles compatibles.
• Sécurité : le composant reçoit le mot de passe d'administration de la box et tourne avec les droits de Home Assistant.
• Présence : comptez une à deux minutes avant qu'un appareil déconnecté passe en « absent ».

Questions fréquentes sur Home Assistant et la Bbox