Divers

Home Assistant Bbox : intégration et configuration

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.

2
intégrations Bbox
HACS
pour l'intégration communautaire
1 à 2 min
de délai pour passer « absent »
En local
même réseau obligatoire

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.

FonctionIntégration officiellehass-bbox2
ConfigurationFichier YAMLInterface, via HACS
Capteurs de traficDébits maximal et courant, durée de fonctionnement, redémarragesMesures de trafic
État de la connexionNonÉtat WAN, adresses IP publique et privée
Appareils connectésDétection de présenceSuivi des appareils, filaires en option
Wi-FiNonActiver ou couper le Wi-Fi et le Wi-Fi invité
BoutonsNonRedémarrer la box, faire sonner le téléphone

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.

Nos conseils de prudence
Faites une sauvegarde avant l'installation, utilisez un mot de passe d'administration unique pour la box et testez d'abord les capteurs avant les interrupteurs Wi-Fi. Si la connexion échoue, vérifiez que Home Assistant joint bien la box en local.

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

Home Assistant fonctionne-t-il avec la Bbox ?
Oui, car il utilise votre réseau local. Pour lire des informations sur la box, vous installez une intégration Bbox.
Quelle intégration choisir pour la Bbox ?
Choisissez hass-bbox2 si vous voulez l'état de la connexion, le contrôle du Wi-Fi ou les boutons. L'intégration officielle suffit pour la présence et les débits.
Faut-il un mot de passe sur la box ?
Oui, l'intégration hass-bbox2 exige un mot de passe d'administration défini sur la box.
Peut-on piloter la Bbox depuis l'extérieur ?
Cela dépend de votre accès à distance à Home Assistant. L'intégration communique avec la box en local.
Partager

Commentaires

Aucun commentaire pour le moment. Soyez le premier à commenter.

Réagir

Publié par
Stéphane