Démarrer avec Home Assistant sur Raspberry Pi (2 méthodes)

Home Assistant fait partie des outils les plus utiles qu’on peut installer sur un Raspberry Pi. Il permet de contrôler tous vos appareils connectés depuis un seul endroit, et dispose de tonnes d’options de personnalisation. Je l’ai installé de nombreuses fois, donc voici un guide clair, étape par étape, pour vous aider à le faire facilement.

Home Assistant est disponible sous forme d’image installable pour le Raspberry Pi qui peut être flashée sur une carte SD comme un système complet. Il est également disponible en tant que conteneur Docker, ce qui permet d’utiliser Home Assistant aux côtés d’autres services sur le même système.

Je vais couvrir ces deux méthodes d’installation, donc choisissez simplement celle qui correspond le mieux à votre configuration. Ensuite, je vous donnerai quelques conseils pour bien démarrer, quelle que soit la méthode d’installation choisie. C’est parti !

Si vous débutez avec Raspberry Pi ou Linux, j’ai quelque chose qui peut vous aider !
Téléchargez ma fiche mémo des commandes Linux gratuitement – c’est un guide de référence rapide avec toutes les commandes essentielles dont vous aurez besoin utiliser votre Raspberry Pi. Cliquez ici pour l’obtenir gratuitement !

Installation de Home Assistant avec l’image dédiée

Si votre Raspberry Pi sera uniquement dédié à Home Assistant, utilisez cette méthode d’installation. Ce sera beaucoup plus simple sur le long terme.

Vous allez effectuer les mêmes étapes que pour flasher n’importe quelle image de système d’exploitation sur votre Pi. Voici un aperçu de la manière d’installer Home Assistant sur Raspberry Pi :

• Flasher Home Assistant sur une carte SD avec Raspberry Pi Imager.
• Insérer la carte SD dans le Raspberry Pi.
• Démarrer sur Home Assistant

Je vais expliquer chaque étape en détail.

Flasher Home Assistant sur une carte SD

Home Assistant prend officiellement en charge les Raspberry Pi 5, 4B et 3B, donc il propose une image dédiée pour ces modèles.

Remarque : Cette méthode installe l’image 64 bits de Home Assistant. Il est toujours possible de trouver une image 32 bits avec un peu de recherche, mais son support a atteint sa fin de vie.

Voici comment flasher Home Assistant sur une carte SD :

• Téléchargez et installez Raspberry Pi Imager, si vous ne l’avez pas déjà.
  Raspberry Pi Imager est un outil gratuit pour installer facilement un nouveau système d’exploitation, en copiant le fichier depuis une image système vers la carte SD.
• Insérez la carte SD dans votre PC.
  Vous aurez probablement besoin d’un adaptateur SD/MicroSD.
  Et si vous n’avez pas de lecteur de carte SD dans votre PC, vous pouvez acheter un adaptateur USB comme celui-ci. Vous l’utiliserez tout le temps avec votre Raspberry Pi, donc ça vaut le coup d’en avoir un.
• Lancez Raspberry Pi Imager, et faites les sélections suivantes.
• Device – choisissez votre modèle de Pi.
• OS – Naviguez vers Other specific-purpose OS > Home Automation > Home Assistant, et sélectionnez Home Assistant OS.
  
• Storage – pointez vers votre carte SD.
• Writing – cliquez sur le bouton « WRITE » pour commencer le processus de flashage.

Imager va commencer à écrire sur votre carte SD. Après quelques minutes, ce sera terminé, et vous pourrez éjecter la carte SD de votre ordinateur.

Premier démarrage avec Home Assistant

Vous êtes maintenant prêt à démarrer Home Assistant pour la première fois. Pour faciliter les choses, branchez votre Raspberry Pi à un câble réseau avant de l’allumer :

• Insérez la carte SD dans votre Raspberry Pi.
• Assurez-vous que tout le reste est branché (surtout le réseau et l’écran).
• Allumez-le et attendez quelques minutes.

Home Assistant crée une interface web pour que vous puissiez tout gérer, donc il n’y a rien à faire directement sur l’écran, sauf noter l’URL.

Attendez juste un peu que le CLI de Home Assistant apparaisse, et ensuite vous pouvez passer directement à la section Getting Started with Home Assistant (sautez la partie Docker de ce tutoriel).

Remarque : J’ai récemment dû le configurer en Wi-Fi, et ce n’était pas intuitif du tout. Voici ce que j’ai fait au cas où ça vous aide. Commencez par ouvrir le CLI complet avec :
login
Et vous pouvez ensuite utiliser nmcli pour configurer la connexion :
nmcli dev wifi connect 'VOTRE-SSID' password 'VOTRE-MOT-DE-PASSE'
Attention : la disposition du clavier par défaut est QWERTY et il semble qu’il n’y ait aucun moyen de la changer.

Installation de Home Assistant avec Docker

Si vous avez déjà d’autres services sur votre Pi et que vous voulez les garder actifs, utilisez plutôt cette méthode. Installer Home Assistant avec Docker est un excellent choix si vous avez déjà Raspberry Pi OS (ou une autre distribution) en fonctionnement et que vous voulez l’ajouter comme une application supplémentaire.

Mettre à jour votre système

Je teste cette installation sur la dernière version de Raspberry Pi OS disponible au moment où j’écris (Trixie 64 bits), mais cela devrait fonctionner sur n’importe quelle distribution basée sur Debian. Si vous utilisez d’autres systèmes Linux comme Manjaro ou Arch, vous devrez adapter certaines de ces commandes.

Pour éviter les problèmes pendant l’installation, assurez-vous d’abord que votre système est à jour :
sudo apt update
sudo apt upgrade

S’il y a beaucoup de paquets mis à jour, un redémarrage est recommandé avant d’aller plus loin :
sudo reboot

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Installer Docker sur Raspberry Pi

La documentation officielle n’explique pas comment configurer Docker sur le Raspberry Pi, c’est là que vous pourriez vous perdre, donc je vais répondre à vos questions ici.

• Le paquet Docker dans le dépôt par défaut de Raspberry Pi OS est obsolète.
• La meilleure façon d’installer Docker sur Raspberry Pi OS est de lancer cette commande :
  curl -sSL https://get.docker.com | sh
  

Pas besoin d’utiliser sudo, le script le fera pour vous. En gros, cette commande va ajouter un nouveau dépôt à vos sources APT, et installer les paquets depuis là. Quand c’est terminé, Docker démarrera son service automatiquement et affichera la version.

Si vous débutez avec Docker, je recommande de lire mon guide complet sur Docker sur Raspberry Pi d’abord. Juste pour être sûr que vous comprenez bien ce que vous faites.

Créer un conteneur Docker pour Home Assistant

Maintenant que Docker est configuré sur votre système, vous pouvez suivre la documentation et créer un nouveau conteneur avec Home Assistant.

Méthode n°1 : via une commande Docker

Voici la syntaxe de commande pour lancer Home Assistant avec Docker via une commande :

docker run -d \
--name homeassistant \
--privileged \
--restart=unless-stopped \
-e TZ=MY_TIME_ZONE \
-v /PATH_TO_YOUR_CONFIG:/config \
--network=host \
ghcr.io/home-assistant/home-assistant:stable

Oui, c’est une longue commande, et vous devez l’adapter pour votre système :

• Remplacez MY_TIME_ZONE par votre fuseau horaire actuel. Le format est Pays/Ville.
  Par exemple : TZ=Europe/Paris (Vous pourrez peut-être trouver votre fuseau horaire rapidement en tapant la commande « timedatectl »)
• Remplacez PATH_TO_YOUR_CONFIG par le dossier où vous voulez stocker les fichiers de configuration.

Dans mon cas, j’ai simplement utilisé cet exemple :

docker run -d \
--name homeassistant \
--privileged \
--restart=unless-stopped \
-e TZ=Europe/Paris \
-v /home/pat/hass:/config \
--network=host \
ghcr.io/home-assistant/home-assistant:stable

Remarque : Si vous obtenez cette erreur : « docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock », assurez-vous d’avoir suivi notre guide d’installation complètement.

Vous pouvez la corriger en lançant cette commande, en vous déconnectant, puis en vous reconnectant :
sudo usermod -aG docker $USER

Après avoir lancé cette commande, le conteneur va démarrer et l’interface web sera disponible. Vous apprendrez comment y accéder dans la section Getting Started with Home Assistant ci-dessous.

Méthode n°2 : via Docker Compose

Si vous trouvez plus facile de gérer les conteneurs via un fichier texte persistant, vous pouvez lancer Home Assistant via Docker Compose à la place :

• Créez un dossier de projet pour Home Assistant :
  mkdir ~/HA
cd ~/HA
• Dans ce dossier, créez un fichier compose.yaml :
  nano compose.yaml
• Collez les lignes suivantes :

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - ./:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host
    environment:
      TZ: Europe/Amsterdam

• Modifiez ces parties, si nécessaire :
  • « Europe/Amsterdam » avec votre fuseau horaire.
  • « ./:config » fait référence au répertoire actuel. Vous pouvez remplacer la partie « ./ » par un chemin différent si vous voulez stocker les fichiers ailleurs.
• Enregistrez et quittez (CTRL+X).
• Lancez le conteneur Home Assistant :
  docker compose up

Maintenant le conteneur va démarrer et l’interface web devrait être disponible. Vous apprendrez comment y accéder dans la section Getting Started with Home Assistant ci-dessous.

(Si vous voulez en savoir plus sur la façon d’utiliser Docker Compose, consultez notre guide : La façon la plus simple d’utiliser Docker sur Raspberry Pi.)

Facultatif : mettre à jour Home Assistant lors de l’utilisation de Docker

Mettre à jour Home Assistant avec la méthode d’installation Docker est un peu délicat. Vous ne pouvez pas simplement lancer apt upgrade et espérer le maintenir à jour. Après avoir lu la documentation, la seule façon de le mettre à jour semble être de supprimer le conteneur et d’en créer un nouveau avec la nouvelle version.

Voici les commandes à lancer (dans cet ordre) :
sudo docker pull ghcr.io/home-assistant/home-assistant:stable
sudo docker stop homeassistant
sudo docker rm homeassistant

Ensuite, vous pouvez utiliser la même commande que pendant l’installation pour recréer le conteneur. Assurez-vous d’utiliser le même chemin pour le dossier de configuration si vous ne voulez pas repartir de zéro.

Premiers pas avec Home Assistant

Une fois Home Assistant installé, il est maintenant temps d’ajouter tous vos appareils connectés et de commencer à vous amuser avec !

Accéder à l’interface web

Quelle que soit la méthode d’installation choisie, Home Assistant va démarrer une interface web sur le port 8123 de votre Raspberry Pi. Vous pouvez généralement y accéder avec http://homeassistant.local:8123 ou http://ADRESSE_IP:8123.

Vous pouvez consulter cet article sur comment trouver l’adresse IP de votre Raspberry Pi si vous ne la connaissez pas encore.

Vous devriez obtenir un formulaire, comme sur la capture d’écran ci-dessus, vous demandant de créer le premier compte utilisateur.

Ensuite, quelques questions vous seront posées pour personnaliser votre installation :

• Donnez un nom à votre installation Home Assistant.
• Définissez votre emplacement, fuseau horaire, système d’unités et devise.
• Cochez les cases correspondant à la collecte de données que vous souhaitez partager (ou sautez cet écran).
• L’assistant va ensuite scanner votre réseau et proposer d’ajouter rapidement les appareils connectés pris en charge :
  
• Cliquez simplement sur celui que vous voulez ajouter, ou cliquez sur « Finish » pour le faire plus tard.
  Dans mon cas, il a détecté la plupart de ceux qui étaient connectés pendant l’installation (ampoules, prises connectées et NAS).
• L’ajout de chaque appareil peut nécessiter des étapes supplémentaires. Par exemple, pour les ampoules Philips Hue, vous devez appuyer sur le bouton du hub pour permettre à Home Assistant de les contrôler, puis assigner chaque ampoule à une pièce.
• Vous pouvez évidemment cliquer sur « More » pour ajouter des intégrations supplémentaires (comme des sites web ou des choses qui n’ont pas été détectées automatiquement), mais je recommande de le faire une fois dans l’interface complète.

Une fois cet assistant de configuration terminé, vous devriez avoir accès à l’interface complète, avec un joli tableau de bord incluant les intégrations que vous avez configurées :

Vous pouvez maintenant utiliser cette interface pour gérer vos appareils connectés. Par exemple, je peux éteindre ou allumer la lumière de la cuisine en cliquant sur le bouton correspondant. Mais Home Assistant va bien plus loin.

Ajouter plus d’intégrations

D’abord, assurez-vous de configurer tous vos appareils connectés sur cette interface. Vous pouvez utiliser l’élément Settings dans le menu de gauche pour en ajouter de nouveaux :

• Cliquez sur Settings puis Devices & Services.
  
• Vous obtiendrez la même liste que pendant le processus d’intégration, mais vous pouvez aussi ajouter de nouvelles intégrations.
• Home Assistant est compatible avec énormément de services liés à la domotique.
  Voici quelques exemples : sites web météo, appareils réseau (Unifi, Synology, …), services cloud (Google, Apple, …), robots (aspirateurs), prises connectées (maison, voiture, …), etc.
  Vous aurez la liste complète quand vous cliquerez sur « Add Integration » ; c’est dingue tout ce que vous pouvez surveiller et utiliser dans vos automatisations.
• Vous aurez ensuite des étapes supplémentaires selon l’intégration que vous voulez ajouter.
  Par exemple, pour se connecter à une API météo, vous aurez généralement besoin d’une clé API (vous pouvez souvent en obtenir une gratuitement, juste en créant un compte sur leur site web).
  Pour un robot aspirateur, vous devrez probablement appuyer sur un bouton dessus. Etc.

Essayez d’ajouter quelques intégrations. Home Assistant devient un projet passionnant quand vous avez beaucoup d’appareils connectés et que vous pouvez les faire fonctionner ensemble en créant des automatisations (ex : quand j’ouvre la porte, allume les lumières dans le salon et joue ma chanson préférée). Mais même avec quelques appareils et des services web supplémentaires, vous pouvez déjà construire de beaux tableaux de bord.

Créer un nouveau tableau de bord

Par défaut, Home Assistant va créer un tableau de bord basique appelé « Overview » et un autre nommé « Energy ». Mais vous pouvez les modifier, les supprimer ou en créer de nouveaux. Voici comment :

• Allez dans Settings > Dashboards.
• Cliquez sur le bouton + Add Dashboard.
• Choisissez un titre et une icône :
  
• Puis cliquez sur le Dashboard que vous avez créé dans le menu de gauche pour l’ouvrir.
• Vous pouvez maintenant cliquer dans le menu en haut à droite et choisir « Edit Dashboard » pour le personnaliser.
• À partir de là, vous pouvez faire tout ce que vous voulez : ajouter de nouvelles cartes, en supprimer, déplacer les cartes existantes vers le haut et vers le bas, etc.
• Pour chaque carte, il y a de nombreux modèles que vous pouvez utiliser pour formater les données différemment (bouton, calendrier, graphique d’historique, jauge, etc.).
  
• Après avoir choisi un modèle, vous devrez choisir la valeur exacte que vous voulez afficher dessus.
  Par exemple, dans mon tableau de bord Météo, je peux choisir d’afficher la température, les précipitations, l’indice UV, etc.
  

Vous pouvez penser que c’est compliqué en lisant ça, mais une fois que vous essayez, c’est assez intuitif. Donc je suis sûr que vous comprendrez tout rapidement. Commencez avec quelque chose que vous voulez vraiment avoir sur votre tableau de bord, et trouvez la meilleure façon d’afficher la valeur.

Créer votre première automatisation

Évidemment, Home Assistant n’est pas seulement un moyen d’avoir de jolis tableaux de bord et de remplacer plusieurs applications par une seule. C’est aussi le moyen le plus efficace d’automatiser votre maison.

Une automatisation est un processus qui s’exécutera automatiquement quand un déclencheur est détecté :

• Si la température intérieure descend en dessous de 20 °C, allumer le chauffage.
• Quand un mouvement est détecté dans la chambre, allumer la lumière murale.
• Si le vent dépasse 60 km/h, fermer les volets.
• Etc.

Créer une automatisation n’est pas compliqué une fois que vous avez compris l’idée. Trouvez quelque chose de simple que vous voulez essayer, et suivez ces étapes pour le configurer :

• Allez dans Settings > Automation & Scenes.
• Cliquez sur le bouton + Create Automation.
• Changez le nom de l’automatisation pour quelque chose dont vous vous souviendrez.
  Une phrase qui dit exactement ce qu’elle fait est le mieux.
• Dans la partie triggers, définissez l’appareil qui sera utilisé pour démarrer l’automatisation.
• Puis définissez le capteur de déclenchement exact et la valeur qui démarrera l’automatisation.
  Par exemple, j’ai testé avec AccuWeather (un service web météo), et je dis que quand le plafond nuageux est en dessous d’un certain seuil, cela va démarrer une automatisation pour allumer les lumières de la maison.
  Mais vous pouvez simplement utiliser le déclencheur « Sun », et allumer les lumières au coucher du soleil par exemple.
  
• Vous pouvez ajouter des conditions dans la section suivante si nécessaire.
  Exemple basique : n’allume pas la cuisine si la lumière est déjà allumée.
• Ensuite, définissez les actions qui devraient être déclenchées quand les conditions sont remplies.
  Dans mon cas : Allumer la lumière de la cuisine, par exemple.
  Vous pouvez aussi ajuster d’autres paramètres comme la luminosité pour les lumières, etc.

Essayez de créer quelque chose de simple d’abord, et vérifiez si ça fonctionne. Selon les appareils connectés et les intégrations que vous avez configurés, ce sera plus ou moins facile à tester. Les possibilités sont infinies, essayez juste de penser à quelque chose d’utile pour votre maison.

Vidéo

Conclusion

Dans l’ensemble, Home Assistant est l’un des meilleurs outils pour une maison connectée Raspberry Pi. L’installation est assez simple, et vous pouvez presque tout faire avec. L’interface est intuitive et ne devient compliquée que si vous essayez de créer des automatisations avec plusieurs appareils interconnectés.

Si vous avez des appareils connectés, mais que vous trouvez qu’ils ne sont pas si intelligents que ça, et que vous devez encore faire beaucoup de tâches manuellement, Home Assistant pourrait être ce qui manque dans votre maison. Il pourrait vous faire économiser de l’argent en évitant d’avoir à acheter des appareils dédiés pour obtenir ce que vous voulez.

Essayez d’installer Home Assistant et trouvez des moyens de le rendre utile, comme ces projets de domotique faciles. Cela vous donnera une excuse pour passer plus de temps sur votre Raspberry Pi :-).

Domoticz et HOOBS sont des alternatives à considérer (cliquez sur les liens pour lire mes articles à leur sujet), mais je pense que Home Assistant est mon préféré actuellement.

Si vous utilisez Ubuntu sur votre Raspberry Pi, ou même sur votre ordinateur, vous pouvez consulter cet autre article pour obtenir plus de détails pour cette distribution : Installer Home Assistant sur Ubuntu : Un guide étape par étape (en anglais)

Ressources supplémentaires pour votre Raspberry Pi

Initiation au Raspberry Pi en vidéo
Si vous débutez et voulez passer rapidement à la vitesse supérieure, j’ai exactement ce qu’il vous faut.
Regardez ma formation vidéo qui vous aidera à démarrer du bon bien, choisir votre matériel, installer les meilleures applications et vous lancer directement dans vos premiers projets avec mon aide.
Regarder les vidéos dès maintenant

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources