Installation Home Assistant sur Docker

Dernière mise à jour le 24 mars 2024

Installer Home Assistant sur Docker et rendre votre maison intelligente !

Prérequis
Installation

Home Assistant c’est quoi ?

Pour commencer, bonjour et bienvenue sur mon blog Technologie Geek ! Nous allons voir l’installation d’Home Assistant sur Docker. En premier lieu Home Assistant est une plateforme de domotique open-source. Home Assistant permet de contrôler et d’automatiser de nombreux appareils et systèmes de la maison. En outre elle vous permet de contrôler vos Lumières, thermostats, serrures, caméras de sécurité, enceintes connectées et bien plus encore. Pour finir Vous pourrez l’utiliser avec différents protocoles et technologies de communication, notamment Zigbee, Z-Wave, MQTT, KNX, etc.

De même Home Assistant sur Docker offre une interface utilisateur simple et conviviale. Ensuite vous pourrez configurer des automatisations, des scènes et des scripts pour répondre aux besoins spécifiques de chaque utilisateur. De la même façon vous pourrez également personnaliser l’interface en fonction de vos préférences en utilisant des thèmes et des cartes Lovelace.

En sommes grâce à ses nombreuses intégrations, Home Assistant permet de connecter et de contrôler des appareils de différentes marques et modèles. Cette plateforme est compatible avec plus de 1700 composants. Il est possible d’ajouter de nouvelles intégrations via le système de gestion de modules complémentaires.

En outre Home Assistant sur Docker est une solution de domotique très flexible et évolutive. Vous pourrez l’installer sur différents types de systèmes informatiques, tels que des Raspberry Pi, des NAS ou des serveurs dédiés. En outre, la communauté de Home Assistant est très active et propose régulièrement des mises à jour est des correctifs. De nouveaux composants sont ajoutés régulièrement pour enrichir les fonctionnalités de la plateforme.

En conclusion, Home Assistant est une plateforme de domotique complète. Accessible à tous, Home Assistant sur Docker permet de transformer sa maison en un environnement intelligent et connecté, et de contrôler ses différents appareils de manière centralisée et personnalisée.

Prérequis pour l’installation d’Home Assistant sur Docker :

Présentation
Installation

En premier lieu une installation de Debian.
Ensuite une installation de Docker.
Enfin Portainer installer sur Docker pour l’utilisation du format docker-compose.

Home Assistant avec Portainer et docker-compose :

Présentation
Prérequis

Premièrement, allons sur la page d’administration de Portainer.

Ensuite, sélectionnons notre environnement local.

Puis cliquer sur Stacks.

Pour finir l’installation de Home Assistant sur Docker, cliquer sur add Stack et entrons dans le vif du sujet !

Notre docker compose ou stack dans Portainer :

1. Premièrement dans Name taper le nom de votre Stack. Ici ce sera « homeassistant ».

2. Ensuite dans la partie Web editor, coller le code ci-dessous :

version: '3.8'
services:
  homeassistant:
    image: homeassistant/home-assistant:stable
    container_name: homeassistant
    environment:
      - TZ=Europe/Paris
    ports:
      - 8123:8123
    volumes:
      - /opt/docker/ha/config:/config
      - /etc/localtime:/etc/localtime:ro
    restart: always

3. Enfin en bas de la page appuyer sur le bouton Deploy the stack, puis patienter.

Explication du code :

Version: ‘3.8’ est la version du moteur Docker. Connectez vous en ssh et taper « docker -v ». Ensuite pour plus d’info aller à la page Docker versioning.
services: Démarre un nouveau service.
homeassistant: Est le nom du service.
image: Est le lien vers l’image utilisée. Rendez-vous sur Docker Hub.
container_name: Est le nom du conteneur.
environment: Nous déclarons les variables d’environnement, ici nous nous mettons à l’heure de Paris.
ports: Nous exposons le port 8123 de notre conteneur.
volumes: Ici nous montons le volume dans le dossier /opt/docker/ha/config pour la persistance des données ainsi que le volume /etc/localtime en lecture.
restart: Lorsque le conteneur est stoppé, nous le redémarrons toujours.

Home Assistant sur Docker :

Enfin rendez-vous à l’adresse http://<<ip de votre serveur>>:8123

18 réponses à “Installation Home Assistant sur Docker”

kogarasu
15 novembre 2023
Bonjour,
je suis scrupuleusement le tuto et mon container est bien créé et il est bien en mode running mais quand je me rend sur l’adresse http://192.168.1.35:8123 ça ne fonctionne pas. Une idée de là où pourrait venir le soucis? merci par avance et merci pour ce super tuto.
Répondre
1. Stéphane
  15 novembre 2023
  Bonjour Sylvain,
  1. Dans la liste des conteneurs dans Portainer, dans la colonne Published Ports as-tu 8123:8123 ?
  2. As-tu vérifié que ton volume persistant existe en te connectant en SSH sur ton serveur ?
  Répondre
kogarasu
15 novembre 2023
Bonsoir Stéphane,
merci pour ta réactivité.
Dans la colonne Published Ports je n’ai effectivement pas le port 8123:8123 qui s’affiche malgré toutes mes tentatives de déploiement du conteneur.
J’ai sondé tous les forums possibles et imaginables aujourd’hui et je retrouve souvent l’entrée network: host ou network: bridge dans le YAML, ce qui n’est pas le cas ici. Cela a t’il une importance? Aussi, je vois que dans l’onglet « networks », une fois mon conteneur déployé, une nouvelle entrée apparaît:
– homeassistant_default homeassistant bridge false default 172.25.0.0/16 172.25.0.1
Merci pour ton aide.
Répondre
1. Stéphane
  16 novembre 2023
  Bonsoir,
  network: host donne des privilèges pour accéder à ta carte réseau directement. Normalement Home Assistant n’en a pas besoin.
  Essaie de changer de port et mettre dans le yaml 8124:8123.
  Ensuite, si cela ne marche pas, regarde dans les logs de ton conteneur, il y a un icon dans Portainer pour y accéder.
  As-tu vérifier que ton volume persistant existe ?
  Pour la partie network, si tu ne précises rien, Docker créé un réseau par défaut en mode bridge.
  Répondre
  1. kogarasu
    16 novembre 2023
    Bonsoir Stéphane,
    J’ai passé ma journée dessus (je suis toujours bloqué) et je me suis rendu compte de pas mal de choses depuis.
    – Mon container est déployé et est en statut running sous portainer mais quand je me connecte en SSH et que je fais un docker ps -a je me rend compte qu’il n’a de cesse de redémarrer.
    – Impossible d’avoir des logs que ce soir sur portainer ou en ssh
    – J’ai essayé plein de configuration différentes dans le yaml que ce soit au niveau du paramétre network (en brige, en host, sans rien préciser…), en précisant ou non les ports, en retirant le paramétre pour la timezone, en changeant l’image par « ghcr.io/home-assistant/home-assistant:stable », en précisant un volume ou non… mais rien n’y fait.
    – En ce qui concerne le volume persistant, peux tu préciser ce qu’il me faut vérifier s’il te plaît? Si tu parles du volume dans portainer, il apparaît bien mais reste en « unused ».
    Merci à toi
    Répondre
kogarasu
16 novembre 2023
Update: Si cela peut répondre à ta question, le path /mnt/ha/config est bien créé mais le dossier est vide.
Répondre
1. Stéphane
  16 novembre 2023
  Essaie de changer ton volume par /opt/ha/config par exemple. Le dossier opt est la pour les applications tièrces.
  Tien moi au courant. Je ne pourrais plus te répondre dans l’immédiat je dois partir.
  Répondre
  1. kogarasu
    16 novembre 2023
    J’ai tenté mais même soucis. Je continue d’investiguer. Merci et bonne soirée.
    Répondre
    1. Stéphane
      16 novembre 2023
      Essaie de faire un chmod 777 -R /mnt/ha et de déployer à nouveau ton conteneur.
      As-tu d’autres conteneur sur Docker ?
      Répondre
      1. kogarasu
        17 novembre 2023
        Bonjour Stéphane,
        Même soucis en changeant les permissions.
        Je n’ai rien d’autre qui tourne sur docker non.
      2. Stéphane
        17 novembre 2023
        Bonjour Sylvain,
        As-tu essayé de déployer un autre conteneur ? Peut-tu m’en dire plus sur ton installation, Docker est-il virtualisé ?
      3. Stéphane
        17 novembre 2023
        Je viens de faire un test chez moi, Home Assistant c’est déployer sans soucis. Il faut chercher de coté de Docker je pense.
kogarasu
17 novembre 2023
Merci pour ta réponse. Le soucis vient peut-être de mon support. Je tente de déployer sur un Nas WD MyCloudEx2Ultra. J’avais lu cela possible ici:
https://community.home-assistant.io/t/installing-home-assistant-on-wd-mycloudex2ultra/530270
Je vais continuer d’investiguer de mon côté, tu m’as déjà bien aidé. Merci beaucoup.
Répondre
Pascal B
11 décembre 2023
Bonjour, ça ne marche pas chez moi non plus.
dans les Events, j’ai Container homeassistant exited with status code 143
Répondre
Pascal B
11 décembre 2023
Bonjour,
J’ai installé influxdb, grafana, ça fonctionne parfaitement.
j’ai aussi essayé d’installer avec une autre méthode, rien ne marche.
Répondre
1. Stéphane
  11 décembre 2023
  Bonsoir Pascal,
  Si tu utilise un Nas WD MyCloudEx2Ultra essaie une fois de déployer ton conteneur avec le code ci-dessous :
  version: ‘3.8’
  services:
  homeassistant:
  image: homeassistant/home-assistant:stable
  container_name: homeassistant
  environment:
  – TZ=Europe/Paris
  ports:
  – 8123:8123
  volumes:
  – config:/config
  restart: always
  volumes:
  config: {}
  Répondre
Legastm
16 février 2024
Bonjour,
Merci pour ce super tuto, j’ai installé ha, zigbee2mqtt et mosquito en suivant vos tutos.
Par contre j’aimerais savoir comment je peux mettre à jour home assistant sans perdre ma config ?
Merci
Répondre
1. Stéphane
  16 février 2024
  Bonjour Michaël,
  Oui tu peut mettre à jour sans problème.
  Toutes tes données sont dans le dossier /opt/docker/ha/config (ton volume persistant) de ton serveur.
  1. Tu vas dans Portainer, puis dans Containers et tu supprime le conteneur Home Assistant.
  2. Tu vas dans Stacks, puis tu sélectionne Home Assistant et enfin tu vas dans l’onglet Editor.
  3. Tu clique sur « Update the stack » et tu coche « Re-pull image and redeploy »
  Répondre