{"id":28740,"date":"2024-05-08T23:26:01","date_gmt":"2024-05-08T21:26:01","guid":{"rendered":"https:\/\/www.domorizon.eu\/blog\/?p=28740"},"modified":"2025-03-05T12:51:24","modified_gmt":"2025-03-05T10:51:24","slug":"home-assistant-ha-installation","status":"publish","type":"post","link":"https:\/\/www.domorizon.eu\/blog\/home-assistant-ha-installation\/","title":{"rendered":"Home Assistant (HA) : installation"},"content":{"rendered":"\r\n

Introduction<\/h2>\r\n\r\n\r\n\r\n

La domotique est un ph\u00e9nom\u00e8ne qui existe depuis tr\u00e8s longtemps : on en parlait d\u00e9j\u00e0 dans les ann\u00e9es 80 avec l\u2019automatisation de l’\u00e9clairage, puis avec l’arriv\u00e9e dans les ann\u00e9es 90\/2000 d’Internet, il devenait plus facile de piloter sa domotique et ce qui la composait, mais ce n’est que dans les ann\u00e9es 2010\/2020 qu’un r\u00e9el essor est apparu avec plusieurs solutions commerciales, mais \u00e9galement OpenSource de qualit\u00e9. Pour ne citer que quelques produit, on notera DomoticZ, Domogik, Yana, Jeedom… et Home Assistant.<\/p>\r\n\r\n\r\n\r\n

Home Assistant (aka \u00ab\u00a0HA\u00a0\u00bb) est une des meilleurs solution domotique actuelle… j’ai d’ailleurs migr\u00e9 ma solution DomoticZ que j’utilisais depuis plus de 10 ans vers cette solution plus performante et ayant surtout la capacit\u00e9 de pouvoir g\u00e9rer beaucoup plus de p\u00e9riph\u00e9rique \u00ab\u00a0simplement\u00a0\u00bb que d’autres via un large syst\u00e8me de plugin.<\/p>\r\n\r\n\r\n\r\n

Beaucoup de choses ont d\u00e9j\u00e0 \u00e9t\u00e9 dites sur HA, mais beaucoup de choses, notamment sur l’installation et la configuration de HA ne sont d\u00e9crites qu’en anglais ou partiellement en fran\u00e7ais.<\/p>\r\n\r\n\r\n\r\n

Je vous propose donc plusieurs articles qui seront donc en fran\u00e7ais et d\u00e9taill\u00e9s de fa\u00e7on \u00e0 ce que tout novice en informatique (surtout sous Linux) puissent r\u00e9ussir son installation… La distribution choisie pour r\u00e9aliser notre installation est une D\u00e9bian version 12, mais n’importe quelle distribution Linux pourra faire l’affaire : les versions Ubuntu ou Mint font parti de la lign\u00e9e Debian alors que des Fedora ou CentOS font parti du monde RedHat, il suffira alors de remplacer la commande \u00ab\u00a0apt\u00a0\u00bb par \u00ab\u00a0yum\u00a0\u00bb (ou \u00ab\u00a0dnf\u00a0\u00bb) si vous \u00eates sur l’une de ces distributions.<\/p>\r\n\r\n\r\n\r\n

Cet article commence par \u00e9voquer l’installation de ZigBee2MQTT<\/a> qui est un \u00e9l\u00e9ment essentiel pour piloter les nouveaux p\u00e9riph\u00e9riques\/d\u00e9tecteurs, puis l’installation de HA qui abordera alors les sujets suivant :<\/p>\r\n\r\n\r\n\r\n

    \r\n
  1. Premier lancement et premi\u00e8res configurations<\/li>\r\n\r\n\r\n\r\n
  2. Installer et d\u00e9finir un th\u00e8me de l’interface<\/li>\r\n\r\n\r\n\r\n
  3. Les modules int\u00e9gr\u00e9s et les d\u00e9couvertes<\/li>\r\n\r\n\r\n\r\n
  4. Installer et param\u00e9trer un module<\/li>\r\n<\/ol>\r\n\r\n\r\n

    [tds_warning]ATTENTION <\/em><\/span> Toutes les commandes syst\u00e8me sous Linux seront ex\u00e9cut\u00e9es en \u00e9tant root<\/em>; si vous \u00eates connect\u00e9 sur votre serveur avec un USER normal depuis votre terminal, vous devez commencer par ex\u00e9cuter la commande \u00ab\u00a0sudo -i<\/em>\u00a0\u00bb qui devrait vous passer \u00ab\u00a0root<\/em>\u00a0\u00bb sur votre machine. Des commandes \u00ab\u00a0chown<\/em>\u00a0\u00bb viendront r\u00e9gulariser certains droits sur une partie de la configuration.[\/tds_warning]<\/p>\n\r\n\r\n\r\n

    Installation de ZigBee2mqtt<\/h2>\r\n\r\n\r\n

    [tds_council] ZibBee : kesako<\/span> ? <\/em><\/span> Zigbee est un protocole de haut niveau permettant la communication d’\u00e9quipements personnels ou domestiques \u00e9quip\u00e9s de petits \u00e9metteurs radios \u00e0 faible consommation ; il est bas\u00e9 sur la norme IEEE 802.15.4 pour les r\u00e9seaux \u00e0 dimension personnelle (Wireless Personal Area Networks : WPAN) (Source: Wikipedia<\/a>) Voyez en \u00ab\u00a0Zigbee\u00a0\u00bb, le nouveau \u00ab\u00a0wifi\u00a0\u00bb pour les objets connect\u00e9s, ayant la capacit\u00e9 de pouvoir fonctionner avec une pile pendant plusieurs mois, voir, des ann\u00e9es, ce que ne sait pas faire le Wifi (quelque soit sa version). [\/tds_council]<\/p>\n\r\n\r\n\r\n

    ZigBee2MQTT est un programme OpenSource d\u00e9velopp\u00e9 en JavaScript et ex\u00e9cut\u00e9 sur un moteur NodeJS; ses sources peuvent \u00eatre trouv\u00e9es sur https:\/\/github.com\/zigbee2mqtt\/hassio-zigbee2mqtt<\/a><\/p>\r\n\r\n\r\n

    [tds_note]Pourquoi utiliser des produits ZigBee ?<\/em> <\/span> ZigBee est une sorte de \u00ab\u00a0wifi<\/em>\u00a0\u00bb comme vous l’aurez compris… mais l’une de ses grandes forces est de pouvoir proposer une connexion sans fils pendant des mois, voir des ann\u00e9es. Imaginez vous installer un d\u00e9tecteur (d’ouverture de porte ou fen\u00eatre, d’inondation sous votre meuble de SdB encastr\u00e9, etc…) dont la pile n’aurait que 5 jours d’autonomie ? moi pas…[\/tds_note]<\/p>\n\r\n\r\n\r\n

    ZigBe2MQTT est en r\u00e9alit\u00e9 une passerelle entre les objets\/p\u00e9riph\u00e9riques ZigBee et le reste du monde…<\/p>\r\n\r\n\r\n\r\n

    Pour dialoguer facilement avec le reste du monde, il existe en domotique un protocole qui s’appelle \u00ab\u00a0MQTT\u00a0\u00bb d\u00e9velopp\u00e9 par un employ\u00e9 d’IBM il y a plus de 20 ans (en 1999) pour lui permettre de r\u00e9cup\u00e9rer facilement des donn\u00e9es… d’un ol\u00e9oduc\u00a0 !!!<\/p>\r\n\r\n\r\n\r\n

    Il est en g\u00e9n\u00e9ral associ\u00e9 \u00e0 un serveur MQTT (Ex: mosquitto) qui centralisera les informations envoy\u00e9es par les clients MQTT et pour les mettre \u00e0 disposition des autres clients qui souhaitent traiter ces informations (Ex: Home Assistant, DomoticZ, OpenHAB, etc…).<\/p>\r\n\r\n\r\n\r\n

    Nous allons donc r\u00e9aliser 2 \u00e9tapes :<\/p>\r\n\r\n\r\n\r\n

      \r\n
    1. Installer Mosquitto sur notre machine fonctionnant sous Linux<\/li>\r\n\r\n\r\n\r\n
    2. Installer ZigBee2MQTT toujours sur la m\u00eame machine Linux<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n

      Installation de Mosquitto<\/h3>\r\n\r\n\r\n\r\n

      L’installation du serveur MQTT \u00ab\u00a0Mosquitto\u00a0\u00bb est ce qu’il y a de plus facile : en \u00e9tant connect\u00e9 \u00ab\u00a0root\u00a0\u00bb avec un terminal sur votre machine Linux, ex\u00e9cutez la commande suivante :<\/p>\r\n\r\n\r\n

      \r\napt install mosquitto\r\n<\/pre><\/div>\r\n\r\n\r\n
      Voil\u00e0 !!!<\/p>\r\n\r\n\r\n\r\n
      Votre premier serveur est install\u00e9 et fonctionnel… Facile<\/p>\r\n\r\n\r\n\r\n
      Bien sur on aurait pu compliquer les choses, notamment en rajoutant dans le fichier de configuration un USER et son mot de passe, un certificat, etc… mais nous sommes dans notre r\u00e9seau local et il y a peu de chance que quelqu’un vienne \u00ab\u00a0\u00e0 l\u2019int\u00e9rieur\u00a0\u00bb, pirater votre installation. De plus cet article est l\u00e0 pour vous mettre rapidement en selle sur une solution que vous perfectionnerez par la suite…<\/p>\r\n\r\n\r\n\r\n
      Installation de ZigBee2MQTT<\/h3>\r\n\r\n\r\n\r\n
      Sous Unix, l’un des principe est que tout binaire doit \u00eatre ex\u00e9cut\u00e9 avec un USER autre que root; dans le cas de ZigBee2MQTT on va cr\u00e9er un USER sp\u00e9cifique pour cela et qui s’appellera \u00ab\u00a0zigbee\u00a0\u00bb :<\/p>\r\n\r\n\r\n
      \r\nadduser zigbee\r\n<\/pre><\/div>\r\n\r\n\r\n
      La commande va demander plusieurs choses, je vous propose de passer ces \u00e9l\u00e9ments en tapant plusieurs fois que la touche \u00ab\u00a0Enter<\/em>\u00a0\u00bb de votre clavier – compris pour la d\u00e9finition du mot de passe :<\/p>\r\n\r\n\r\n
      \r\nHomeAssistant:\/# adduser zigbee\r\nAjout de l'utilisateur \u00ab\u00a0zigbee\u00a0\u00bb ...\r\nAjout du nouveau groupe \u00ab\u00a0zigbee\u00a0\u00bb (1001) ...\r\nAjout du nouvel utilisateur \u00ab\u00a0zigbee\u00a0\u00bb (1001) avec le groupe \u00ab\u00a0zigbee\u00a0\u00bb (1001) ...\r\nCr\u00e9ation du r\u00e9pertoire personnel \u00ab\u00a0\/home\/zigbee\u00a0\u00bb ...\r\nCopie des fichiers depuis \u00ab\u00a0\/etc\/skel\u00a0\u00bb ...\r\nNouveau mot de passe\u00a0: \r\nRetapez le nouveau mot de passe\u00a0: \r\nAucun mot de passe n\u2019a \u00e9t\u00e9 fourni.\r\nNouveau mot de passe\u00a0: \r\nRetapez le nouveau mot de passe\u00a0: \r\nAucun mot de passe n\u2019a \u00e9t\u00e9 fourni.\r\nNouveau mot de passe\u00a0: \r\nRetapez le nouveau mot de passe\u00a0: \r\nAucun mot de passe n\u2019a \u00e9t\u00e9 fourni.\r\nMot de passe\u00a0: Erreur de manipulation du jeton d\u2019authentification\r\npasswd\u00a0: mot de passe inchang\u00e9\r\nEssayer \u00e0 nouveau\u00a0? [o\/N]\r\nModifier les informations associ\u00e9es \u00e0 un utilisateur pour zigbee\r\nEntrer la nouvelle valeur, ou appuyer sur ENTER pour la valeur par d\u00e9faut\r\n    NOM []: \r\n    Num\u00e9ro de chambre []: \r\n    T\u00e9l\u00e9phone professionnel []: \r\n    T\u00e9l\u00e9phone personnel []: \r\n    Autre []: \r\nCette information est-elle correcte\u00a0? [O\/n]\r\nAjout du nouvel utilisateur \u00ab\u00a0zigbee\u00a0\u00bb aux groupes suppl\u00e9mentaires \u00ab\u00a0users\u00a0\u00bb ...\r\nAjout de l'utilisateur \u00ab\u00a0zigbee\u00a0\u00bb au groupe \u00ab\u00a0users\u00a0\u00bb ...\r\n<\/pre><\/div>\r\n\r\n\r\n
      L’installation de ZigBee2MQTT va se faire ensuite dans le dossier \/opt de votre serveur : il convient donc de poss\u00e9der ce type de r\u00e9pertoire… Dans le cas contraire, ajustez les FileSystem de votre Linux pour qu’il pr\u00e9sente un r\u00e9pertoire \u00e0 la racine du serveur.<\/p>\r\n\r\n\r\n
      [tds_note]En cas d’absence de \/opt, plusieurs options s’offrent \u00e0 vous :<\/p>\n