Installation de Domoticz sur Raspberry Pi (Guide Complet)

Domoticz est un système de domotique, comme Home Assistant ou d’autres outils similaires. Il peut être installé sur un Raspberry Pi pour contrôler et surveiller la plupart des appareils intelligents que vous pouvez avoir à la maison (lumières, capteurs, aspirateurs robots, etc.) sur une interface web. Je l’ai testé pour vous, et le processus d’installation n’est pas vraiment simple, je vais donc prendre le temps d’expliquer chaque étape dans cet article.

Domoticz est disponible sous la forme d’un conteneur Docker, qui fonctionne sur Raspberry Pi OS. Une fois que tous les prérequis sont prêts, il peut être créé avec la ligne de commande suivante :
docker pull domoticz/domoticz.

Cependant, le processus d’installation ne sera pas si simple si vous partez de zéro, alors continuez à lire cet article afin de procéder de la bonne manière et ne rater aucune étape. Je vais vous présenter le processus d’installation complet et les premières étapes de la connexion à vos appareils intelligents.

À propos, si vous débutez sur Raspberry Pi et que vous souhaitez accélérer les choses (tout en vous amusant), n’hésitez pas à télécharger mon e-book Maitrisez Raspberry Pi en 30 jours. Il s’agit d’un défi de 30 jours dans lequel vous apprendrez une nouvelle compétence chaque jour. Vous économiserez du temps et de l’argent et pourrez enfin profiter de votre Raspberry Pi à son plein potentiel. Je vous offre d’ailleurs 10% de remise aujourd’hui si vous utilisez ce lien !

Installation de Domoticz

Voici les étapes nécessaires pour installer Domoticz sur un Raspberry Pi :

• Installez Raspberry Pi OS (Buster en version 32-bit, est recommandée par Domoticz).
• Installez Docker sur Raspberry Pi OS.
• Récupérez l’image docker pour Domoticz, et lancez le conteneur.

Voyons comment procéder.

Introduction

Le site officiel de Domoticz (en anglais) n’est pas vraiment clair. Je m’attendais à une image de carte SD pour obtenir Domoticz sur mon Raspberry Pi, mais ce n’est pas le cas. Dans la section téléchargement, vous trouverez une archive avec le code source de Domoticz, sans autre explication.

Si vous scrollez jusqu’au bas de la page de téléchargement, il y a aussi un script que vous pouvez exécuter pour l’installer sur Raspberry Pi OS ou Ubuntu, et enfin, ils parlent aussi d’une image Docker.

Globalement, je pense que Docker est la meilleure façon d’installer Domoticz sur votre Raspberry Pi, et vous devriez probablement utiliser cette méthode. Je vais donc vous expliquer comment faire cela dans cet article.

Vous pouvez essayer de suivre le Wiki si vous préférez une autre option. Je l’ai fait et je me suis retrouvé un peu perdu dans les instructions, avec des prérequis peu clairs et un serveur de téléchargement qui n’existe plus.

Prérequis

Comme Domoticz est fortement basé sur des plugins Python, il est recommandé de suivre ces pré-requis :

• Raspberry Pi OS Buster (Legacy), 32-bit.
  Le 64-bit est supporté, mais il n’y avait pas encore de version stable avec Buster, donc à moins que vous n’ayez absolument besoin de la version 64-bit, j’utiliserais la Legacy 32-bit.
  La version Lite est suffisante, c’est celle que j’ai utilisée pour ce tutoriel.
• N’importe quel modèle de Raspberry Pi.
  J’ai testé avec un Pi 4, mais cela devrait fonctionner avec tous les modèles.
• Il vous faudra moins 4 Go disponibles sur votre carte SD ou votre clé USB.

Si vous partez de zéro, je vous laisse installer Raspberry Pi OS, le configurer (Internet, configuration régionale, etc.) et faire les mises à jour du système avant d’aller plus loin. Vous pouvez trouver mon guide d’installation de Raspberry Pi OS ici, si vous avez besoin d’aide à ce sujet.

Installer Docker sur Raspberry Pi OS

Le dernier prérequis pour utiliser Domoticz sur Raspberry Pi est d’avoir Docker installé, ce qui n’est pas le cas par défaut.

Voici comment installer Docker sur Raspberry Pi OS :

• Téléchargez le script d’installation officiel de Docker :
  curl -fsSL https://get.docker.com -o get-docker.sh
• Exécutez-le avec sudo :
  sudo sh get-docker.sh

C’est tout, Docker est maintenant prêt à être utilisé avec n’importe quel projet.

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 Domoticz avec Docker

Une fois que Docker est installé, vous pouvez facilement télécharger le conteneur Domoticz depuis le hub Docker avec :
sudo docker pull domoticz/domoticz

Note : Si vous voulez essayer une version bêta ou une version spécifique, vous pouvez le spécifier dans cette commande. Par exemple :
sudo docker pull domoticz/domoticz:beta
sudo docker pull domoticz/domoticz:2022.1

À lire si vous êtes perdus : Les Bases De Docker Sur Raspberry Pi (Guide Complet)

Démarrer Domoticz

La dernière étape consiste à l’exécuter pour la première fois, avec toutes les options obligatoires. Il y a quelques erreurs dans la documentation officielle. Sudo était nécessaire dans mon cas. Voici la commande correcte :

sudo docker run -d \
-p 8080:8080 \
-p 8443:443 \
-v /home/pi/domoticz:/opt/domoticz/userdata \
-e TZ=Europe/Paris \
--device=/dev/mmcblk0p1 \
--name=domoticz \
domoticz/domoticz

Vous devrez peut-être ajuster ces valeurs en fonction de votre configuration :

• p: Les ports utilisés pour l’interface web. Par défaut, il s’agit de 8080 (HTTP) et 8443 (HTTPS). Veillez à utiliser d’autres ports si vous avez d’autres serveurs Web sur votre système.
• v: Là où vous voulez stocker les fichiers de Domoticz (plugins par exemple).
• e: Modifiez le fuseau horaire en fonction de votre emplacement.
  Vous pouvez utiliser cette commande pour obtenir une liste de tous les fuseaux horaires :
  timedatectl list-timezones
Plus de détails dans cet article.
• device: Je ne suis pas sûr de cela, je l’ai défini avec le nom du périphérique de ma carte SD, mais je ne sais pas vraiment pourquoi c’est nécessaire.
  Utilisez cette commande pour trouver le vôtre :
  df -h | grep boot
• name: Le nom du conteneur de votre Docker.

Quoi qu’il en soit, vous pouvez prendre ma commande telle qu’elle est et modifier les paramètres plus tard, si nécessaire.

Si vous rencontrez un quelconque problème à ce stade, le forum officiel est probablement un bon endroit pour demander de l’aide.

Premiers pas avec Domoticz

Interface web

Si tout s’est bien passé lors de l’installation, vous devriez maintenant avoir accès à l’interface web.
Tapez l’adresse IP de votre Raspberry Pi, suivie du port que vous avez défini dans la commande précédente. Cela devrait être quelque chose comme :
http://<IP_ADDRESS>:8080

Par exemple :
http://192.168.1.20:8080

Si vous ne connaissez pas votre adresse IP, vous pouvez suivre ce guide pour l’obtenir, quelle que soit votre configuration actuelle.

L’interface est vide par défaut, vous devrez d’abord configurer vos appareils. Contrairement à Home Assistant, il n’y a pas d’assistant pour vous aider dans les premières étapes. Je vais vous donner quelques conseils généraux dans les prochains paragraphes. Cependant, vous devrez prendre un peu de temps pour trouver la meilleure façon d’ajouter vos appareils intelligents ici, chaque matériel est différent.

Paramètres

Avant d’aller plus loin, je vous recommande de vérifier la page des paramètres de Domoticz, et de changer tout ce qui doit l’être : la langue et l’emplacement en particulier, et peut-être définir un mot de passe pour une meilleure sécurité.

La localisation est utilisée par divers plugins, ce qui vous fera gagner du temps par la suite. Cliquez sur le lien situé sous le formulaire pour obtenir votre latitude et votre longitude actuelles, puis remplissez le formulaire. Cliquez sur « Apply Settings » pour enregistrer les modifications.

Une fois l’emplacement enregistré, vous verrez apparaître une nouvelle ligne en haut de chaque page, avec l’heure actuelle et les heures de lever et de coucher du soleil. Les prévisions météorologiques actuelles seront également affichées sur la page Météo :

Ajoutez vos premiers appareils connectés

La configuration de base est maintenant terminée, et vous pouvez passer à la connexion de tous les dispositifs intelligents que vous voulez gérer avec Domoticz. Il y a des dizaines de marques et de dispositifs supportés par défaut, et vous pouvez également installer des add-ons pour vous connecter à d’autres dispositifs intelligents, donc je ne serai pas exhaustif ici, mais prenons un exemple rapide.

Comme vous le savez peut-être déjà, je suis un fan des ampoules intelligentes Philips Hue, je les utilise souvent comme exemple dans mes articles et mes livres. Elles sont supportées par défaut par Domoticz, je vais donc vous montrer comment les utiliser. Cette procédure devrait être similaire pour la plupart des dispositifs :

• Allez vers Setup > Hardware.
• Remplissez le champ Name avec ce que vous voulez, par exemple : « Lumières ».
• Dans la liste « Type » list, trouvez « Philips Hue bridge ».
  Le formulaire sera différent avec chaque appareil, par exemple, dans ce cas, j’ai :
  
• Remplissez le formulaire avec les valeurs demandées.
  Dans mon exemple, j’ai surtout besoin de l’adresse IP du pont et du port (80).
  J’ai ensuite besoin d’appuyer sur le bouton de lien de celui-ci et de cliquer sur enregistrer pour permettre à Domoticz d’interagir avec lui.
  Selon le matériel que vous ajouterez, il peut s’agir d’un nom d’utilisateur, d’un jeton d’API, etc.
• Cliquez sur « Add » pour enregistrer et ajouter les nouveaux dispositifs.

Vous les trouverez ensuite dans Setup > Devices, et dans certains cas, ils seront ajoutés à la page correspondante. Par exemple, mes lumières sont maintenant disponibles sur la page « Switches », et je peux les configurer directement à partir de là :

Évidemment, cela va beaucoup plus loin, puisque vous pouvez créer des scènes et des scripts pour tout automatiser. Ce n’est pas le but de cet article, mais vous êtes invités à jouer avec Domoticz une fois que tous vos appareils sont installés. La partie amusante commence lorsque vous commencez à les faire fonctionner ensemble :-).

FAQ

Où est installé Domoticz sur mon Raspberry Pi ?

Le dossier Domoticz est créé lors de l’installation, par défaut, c’est /home/pi/domoticz. Mais vous pouvez le changer pendant l’installation manuelle, et la première exécution du conteneur docker.

Si vous ne vous souvenez pas où vous l’avez installé, vous pouvez utiliser cette commande pour le retrouver :
sudo find / -iname domoticz.db

Comment mettre à jour Domoticz ?

La manière la plus simple de mettre à jour Domoticz est de le faire depuis l’interface web. Allez dans « Setup » > « Check for Update » et suivez l’assistant si une mise à jour est disponible.

Si vous utilisez Docker comme expliqué dans ce guide, la mise à jour de Domoticz peut également être effectuée avec docker-compose :
docker-compose pull domoticz
docker-compose down
docker-compose up -d --remove-orphans
docker image prune

Conclusion

Domoticz est un bel outil de domotique, qui permet de connecter tous vos appareils intelligents sur une seule interface, et d’essayer de les faire fonctionner ensemble, via divers scripts et scènes. Mais, pour être honnête, après avoir testé Home Assistant quelques semaines avant d’écrire ce tutoriel, je ne suis pas vraiment impressionné par Domoticz, et je comprends mieux les résultats de mon sondage sur la chaîne YouTube:

Je trouve l’installation de Home Assistant plus facile, son site web est mieux conçu et il y a une image, prête à l’emploi. De plus, un assistant de bienvenue détecte automatiquement les appareils sur votre réseau, et vous pouvez les ajouter en quelques clics. Globalement, l’interface de Home Assistant est bien plus agréable et intuitive que celle de Domoticz.

Si vous avez vraiment besoin d’utiliser Domoticz pour une raison quelconque, vous savez maintenant comment l’installer, mais si vous cherchez simplement le meilleur outil de domotique, je vous conseille d’utiliser d’abord Home Assistant. Je n’utilise pas beaucoup ce genre d’outil, donc je peux me tromper, mais ce sont mes premières impressions après avoir testé les deux.

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