Démarrer avec Home Assistant sur Raspberry Pi (2 façons)

Installer Home Assistant est un projet très courant pour tout propriétaire de Raspberry Pi. Une fois connecté à votre réseau, Home Assistant peut contrôler tous vos appareils intelligents depuis une interface unique. Dans ce tutoriel, je vous montrerai comment le faire fonctionner pour automatiser votre domicile.

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

Je vais expliquer ces deux méthodes d’installation, alors choisissez celle qui convient le mieux à votre configuration. Ensuite, je vous donnerai quelques conseils pour bien démarrer, quelle que soit la méthode d’installation que vous avez choisie. Allons-y !

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 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 à long terme.

Vous effectuerez les mêmes étapes que pour flasher une image de système d’exploitation sur votre Pi. Voici un aperçu de la façon d’installer Home Assistant sur Raspberry Pi :

• Flashez l’image sur une carte SD avec Raspberry Pi Imager.
• Insérez la carte SD dans le Raspberry Pi.
• Démarrez dans Home Assistant

Je vais expliquer chaque étape en détail ensuite.

Flasher Home Assistant sur une carte SD

Home Assistant prend officiellement en charge les Raspberry Pi 5, 4B et 3B, donc des images spécifiques sont disponibles.

Remarque : Cette méthode installera l’image 64 bits de Home Assistant. Il est encore possible de trouver une image 32 bits en cherchant bien, mais son support a pris fin.

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 d’une image système sur la carte SD.
• Insérez la carte SD dans votre ordinateur.
  Vous aurez probablement besoin d’un adaptateur de carte SD/MicroSD.
  Et si vous n’avez pas de lecteur de carte SD dans votre ordinateur, vous pouvez acheter un adaptateur USB comme celui-ci. Vous l’utiliserez tout le temps avec votre Raspberry Pi, donc cela vaut la peine d’en avoir un.
• Lancez Raspberry Pi Imager
• Sélectionnez ces options :
  • Appareil Raspberry Pi : choisissez votre modèle de Pi.
  • Système d’exploitation : sélectionnez Autres OS à usage spécifique > Assistants domestiques et domotique > Home Assistant > Home Assistant OS
    
  • Stockage : sélectionnez votre carte SD
• Cliquez sur Next. Imager vous avertira que toutes les données de votre carte SD seront effacées. Tapez OUI.
  

Imager va commencer à écrire sur votre carte SD. Après quelques minutes, cela devrait être terminé, et vous pouvez é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 simplifier les choses, veuillez brancher 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 vous permettre de tout gérer, donc vous n’avez rien à faire directement sur l’écran, sauf prendre note de l’URL.

Attendez simplement un moment pour que la ligne de commande de Home Assistant apparaisse, puis vous pouvez passer à la section Premiers pas avec Home Assistant (ignorez la partie Docker de ce tutoriel).

Installation de Home Assistant avec Docker

Si vous avez déjà d’autres services sur votre Pi et souhaitez 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 cours d’exécution et souhaitez l’ajouter comme si c’était une application supplémentaire.

Mettez à jour votre système

Je teste cette configuration sur la dernière version de Raspberry Pi OS disponible au moment de l’écriture (Bookworm 64 bits), mais cela devrait fonctionner sur toute distribution qui repose 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 lors de 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 de poursuivre :
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, ce qui peut vous faire perdre le fil, donc je répondrai à vos questions ici.

• Docker n’est pas disponible dans le dépôt APT sur Raspberry Pi OS.
• Le moyen le plus simple d’installer Docker sur Raspberry Pi est d’utiliser cette commande :
  curl -sSL https://get.docker.com | sh
  

Vous n’avez 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 à partir de là.

Si vous êtes nouveau dans ce domaine, je vous recommande de lire d’abord mon guide complet sur Docker sur Raspberry Pi. Juste pour vous assurer que vous comprenez ce que vous faites ici.

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.

Voici la syntaxe de commande pour le faire :

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

Oui, la commande est très longue, et vous devez l’ajuster à votre système :

• Remplacez MON_FUSEAU_HORAIRE 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 CHEMIN_VERS_VOTRE_CONFIGURATION par le dossier où vous souhaitez stocker les fichiers de configuration.

Dans mon cas, j’ai simplement utilisé cette commande :

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”

Vous pouvez la corriger avec :
sudo chmod 666 /var/run/docker.sock

Après avoir exécuté cette commande, le conteneur démarrera et l’interface web sera disponible. Vous apprendrez comment y accéder dans la section Premiers pas avec Home Assistant ci-dessous.

Facultatif : mettre à jour Home Assistant en utilisant Docker

Mettre à jour Home Assistant avec la méthode d’installation Docker est un peu délicat. Vous ne pouvez pas simplement exécuter apt upgrade et espérer qu’il sera mis à jour. Après avoir lu la documentation, le seul moyen de le mettre à jour semble être de supprimer le conteneur et d’en créer un nouveau avec la nouvelle version.

Voici la commande à exécuter (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 lors de 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 recommencer à zéro.

Premiers pas avec Home Assistant

Une fois Home Assistant installé, il est temps de le connecter à tous vos appareils intelligents et de commencer à vous amuser avec !

Accéder à l’interface web

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

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

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

Ensuite, vous serez invité à répondre à quelques questions pour personnaliser votre configuration :

• 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 passez cet écran).
• L’assistant analysera alors votre réseau et proposera d’ajouter rapidement les appareils intelligents pris en charge :
  
• Cliquez simplement sur ceux que vous souhaitez ajouter, ou cliquez sur “Finish” pour le faire plus tard.
  Dans mon cas, il a détecté la plupart des appareils qui étaient connectés lors de l’installation (lumières, prises connectées et NAS).
• L’ajout de chaque appareil peut nécessiter des étapes supplémentaires. Par exemple, pour les lumières Philips Hue, vous devez appuyer sur le bouton du hub pour permettre à Home Assistant de les contrôler, puis assigner chaque lumière à une pièce.
• Vous pouvez évidemment cliquer sur “More” pour ajouter des intégrations supplémentaires (comme des sites web ou des éléments qui n’ont pas été détectés automatiquement), mais je recommande de faire cela 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 intelligents. 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 que cela.

Ajouter plus d’intégrations

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

• Cliquez sur Settings, puis sur Devices & Services.
  
• Vous obtiendrez la même liste que lors du processus de configuration initiale, mais vous pouvez également ajouter de nouvelles intégrations.
• Home assistant est compatible avec de nombreux services liés à la domotique.
  Voici quelques exemples : sites météo, appareils réseau (Unifi, Synology, …), services cloud (Google, Apple, …), robots (aspirateurs), prises connectées (maison, voiture, …), etc.
  Vous obtiendrez la liste complète lorsque vous cliquerez sur “Add Integration”. C’est fou tout ce que vous pouvez surveiller et utiliser dans vos automatisations.
• Vous aurez ensuite des étapes supplémentaires selon l’intégration que vous souhaitez 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, simplement en créant un compte sur leur site web).
  Pour un robot aspirateur, vous devrez probablement appuyer sur un bouton, etc.

Essayez d’ajouter quelques intégrations. Home Assistant devient un projet passionnant lorsque vous avez de nombreux appareils intelligents et que vous pouvez les faire fonctionner ensemble en créant des automatisations (par exemple : quand j’ouvre la porte, allumer les lumières dans le salon et lancer ma chanson préférée). Mais même avec quelques automatisations et quelques services web, vous pouvez déjà créer de beaux tableaux de bord.

Créer un nouveau tableau de bord

Par défaut, Home Assistant créera 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 :
  
• Ensuite, cliquez sur le tableau de bord 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 certaines, déplacer les cartes existantes vers le haut et le bas, etc.
• Pour chaque carte, il existe de nombreux modèles que vous pouvez utiliser pour formater les données différemment (bouton, calendrier, graphique historique, jauge, etc.).
  
• Après avoir choisi un modèle, vous devrez choisir la valeur exacte que vous souhaitez 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. Je suis donc sûr que vous comprendrez tout rapidement. Commencez par 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 une manière d’avoir de beaux tableaux de bord et de remplacer plusieurs applications. C’est aussi le moyen le plus efficace d’automatiser votre maison.

L’automatisation est un processus qui s’exécute automatiquement lorsqu’un déclencheur est détecté :

• Si la température intérieure descend en dessous de 20 °C, allumer le chauffage.
• Lorsque du 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 en avez compris le principe. Trouvez quelque chose de simple que vous voulez tester, et suivez ces étapes pour la configurer :

• Allez dans Settings > Automation & Scenes.
• Cliquez sur le bouton + Create Automation.
• Changez le nom de l’automatisation en quelque chose que vous retiendrez.
  Une phrase indiquant exactement ce qu’elle fait est préférable.
• Dans la partie déclencheurs, définissez l’appareil qui sera utilisé pour lancer l’automatisation.
• Ensuite, définissez le capteur de déclenchement exact et la valeur qui déclencheront l’automatisation.
  Par exemple, j’ai testé avec AccuWeather (un service météo en ligne), et j’ai indiqué que lorsque le plafond nuageux est en dessous d’un certain seuil, il démarrera une automatisation pour allumer 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 simple : ne pas allumer la cuisine si la lumière est déjà allumée.
• Ensuite, définissez les actions qui doivent être déclenchées lorsque les conditions sont remplies.
  Dans mon cas : allumer la lumière de la cuisine, par exemple.
  Vous pouvez également ajuster d’autres paramètres comme la luminosité pour les lumières, etc.

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

Vidéo

Réflexions finales

Dans l’ensemble, Home Assistant est une excellente application. L’installation est assez simple, et vous pouvez faire presque tout avec. L’interface est intuitive, elle devient juste compliquée si vous essayez de créer des automatisations complexes avec plusieurs appareils intelligents interconnectés.

Si vous avez des appareils intelligents, mais constatez qu’ils ne sont pas si intelligents, et que vous devez encore effectuer de nombreuses tâches manuellement, Home Assistant pourrait être ce qui manque à votre maison. Essayez de l’installer et trouvez des moyens de le rendre utile, vous aurez 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 à ce 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 sur 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