Comment installer Domoticz sur Raspberry Pi (Guide complet)

Domoticz est un système d’automatisation 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 objets connectés que vous avez chez vous (ampoules, capteurs, aspirateurs robots, etc.) via une interface web. Je l’ai testé pour vous, et le processus d’installation n’est pas vraiment simple, donc je vais prendre le temps d’expliquer chaque étape dans cet article.

Un conteneur Docker Domoticz officiel est disponible et fonctionne sur Raspberry Pi OS. Une fois tous les prérequis prêts, il peut être créé avec une seule ligne de commande : docker pull domoticz/domoticz.

Mais le processus d’installation ne sera pas si facile si vous partez de zéro, alors lisez la suite pour tout faire dans le bon ordre et ne manquer aucune étape. Je vais vous donner le processus d’installation complet, et les premières étapes pour vous connecter à vos objets connectés.

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 !

Introduction à Domoticz

Le site officiel de Domoticz 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 de téléchargement, vous obtiendrez une archive avec le code source de Domoticz, sans plus d’explications.

Si vous faites défiler jusqu’en 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.

Dans l’ensemble, je pense que l’image Docker est la meilleure façon d’installer Domoticz sur votre Raspberry Pi, et vous devriez probablement suivre cette voie. C’est celle que je vais expliquer dans cet article.

Vous pouvez essayer de suivre le Wiki si vous préférez une autre option, mais je l’ai fait et je me suis 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 (bookworm).
  Les versions 64 bits et 32 bits devraient toutes deux être prises en charge.
  La version Lite suffit, c’est celle que j’ai utilisée pour ce tutoriel.
• Raspberry Pi – La version la plus récente nécessite soit un Raspberry Pi 5, Pi 4, ou Pi 3B+.
• Stockage – Au moins 4 Go disponibles sur votre carte SD ou 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.

Installation de Domoticz

En résumé, voici les étapes nécessaires pour installer Domoticz sur un Raspberry Pi :

• Installer Raspberry Pi OS (Bookworm ou plus récent est recommandé par Domoticz).
• Installer Docker sur Raspberry Pi OS.
• Télécharger l’image Docker pour Domoticz et démarrer le conteneur.

Voyons comment faire cela.

Installer Docker sur Raspberry Pi OS

Le prérequis pour faire fonctionner Domoticz sur Raspberry Pi est d’avoir Docker installé, ce qui n’est pas le cas par défaut. Voici comment installer la dernière version de Docker sur Raspberry Pi OS (méthode recommandée) :

• Exécutez le script d’installation officiel de Docker :
  curl -sSL https://get.docker.com | sh
• Ajoutez votre utilisateur au groupe Docker :
  sudo usermod -aG docker $USER
• Déconnectez-vous et reconnectez-vous pour que les changements prennent effet.

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

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

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 !

Créer la configuration Docker de Domoticz

Il est maintenant recommandé d’utiliser un fichier Docker Compose pour Domoticz.
Ce fichier téléchargera et exécutera Domoticz pour vous.

Voici comment créer une configuration Docker Compose pour Domoticz :

• Créez un dossier pour accueillir votre projet :
  mkdir domoticz
• À l’intérieur de ce dossier, créez un fichier YAML :
  cd domoticz
nano compose.yaml
• Collez le texte ci-dessous (l’indentation est importante !) :

services:
  domoticz:
    image: domoticz/domoticz:stable
    container_name: domoticz
    restart: unless-stopped
    # Passer les appareils au conteneur
    # devices:
    #   - "/dev/serial/by-id/usb-0658_0200-if00-port0:/dev/ttyACM0"
    ports:
      - "8080:8080"
    volumes:
      - ./config:/opt/domoticz/userdata
      #- ./config/www/templates:/opt/domoticz/www/templates
    environment:
      - TZ=Europe/Amsterdam
      #- LOG_PATH=/opt/domoticz/userdata/domoticz.log

• Ajustez ces valeurs, si nécessaire :
  • ports – Le port utilisé pour l’interface web. Par défaut, c’est 8080 (HTTP).
    Vous pouvez changer la valeur à gauche des deux-points si le port entre en conflit avec d’autres serveurs web fonctionnant sur votre système.
  • TZ : Changez le code de fuseau horaire pour correspondre à votre emplacement.
    Vous pouvez également utiliser cette commande pour obtenir une liste de tous les fuseaux horaires :
    timedatectl list-timezones
Plus de détails et filtre ici.
• Enregistrez et quittez (CTRL+X).

De toute façon, vous pouvez utiliser ma configuration telle quelle, et changer les paramètres plus tard si nécessaire.

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

Démarrer Domoticz

Enfin, il est temps de déployer le conteneur Domoticz.
La méthode est la même que pour lancer n’importe quel autre conteneur Docker.

Dans votre dossier de projet, exécutez cette commande :
docker compose up

Vous devriez voir Docker télécharger l’image Domoticz et la lancer.

Remarque : Plus tard, une fois que vous serez à l’aise avec votre configuration, vous pourrez utiliser cette commande pour l’exécuter en arrière-plan :
docker compose up -d

Premiers pas avec Domoticz

Si tout s’est bien passé pendant l’installation, vous devriez maintenant avoir accès à l’interface web.
Chargeons-la et voyons.

Interface web

Entrez l’adresse IP de votre Raspberry Pi, suivie du port que vous avez défini dans la commande précédente. Cela devrait ressembler à :
http://<ADRESSE_IP>: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.

Vous serez accueilli par l’écran de connexion. Utilisez ces identifiants par défaut :
nom d’utilisateur = admin
mot de passe = domoticz

Une fois à l’intérieur, 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 avec les premières étapes. Je vais donner quelques conseils généraux dans les paragraphes suivants, mais vous devrez prendre un peu de temps pour trouver la meilleure façon d’ajouter vos objets connectés ici, chaque matériel est différent.

Paramètres

Avant d’aller plus loin, je vous recommande de vérifier l’onglet Configuration de Domoticz, et de changer tout ce qui doit être changé : langue et emplacement sous ‘Settings‘, et peut-être changer le mot de passe par défaut sous ‘Users‘ pour renforcer la sécurité.

L’emplacement est utilisé par divers plugins, donc cela vous fera gagner du temps plus tard. Cliquez sur le lien sous le formulaire pour obtenir votre latitude et longitude actuelles, et remplissez le formulaire. Cliquez sur « Apply Settings » pour enregistrer les modifications.

Une fois l’emplacement enregistré, vous verrez une nouvelle ligne en haut de chaque page, avec l’heure actuelle, et les heures de lever et de coucher du soleil. Il affichera également les prévisions météo actuelles sur la page Weather :

Ajouter vos premiers appareils

La configuration de base est maintenant terminée, et vous pouvez passer à la connexion de tous les objets connectés que vous souhaitez gérer avec Domoticz. Il y a des dizaines de marques et d’appareils pris en charge par défaut, et vous pouvez également installer des modules complémentaires pour vous connecter à d’autres objets connectés, donc je ne vais pas être exhaustif ici, mais prenons un exemple rapide.

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

• Allez dans Setup > Hardware.
• Remplissez le champ Name avec ce que vous voulez, par exemple : « Lights ».
• Dans la liste « Type », trouvez « Philips Hue bridge« .
  Le formulaire sera différent selon 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).
  Je dois ensuite appuyer sur le bouton de lien sur celui-ci et cliquer sur enregistrer pour permettre à Domoticz d’interagir avec lui.
  Selon le matériel que vous ajoutez, cela peut être un nom d’utilisateur, un jeton API, etc.
• Cliquez sur « Add » pour enregistrer et ajouter les nouveaux appareils.

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

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

Vidéo

Domoticz est un bon outil pour l’automatisation de la domotique, car il regroupe tous vos objets connectés dans une seule interface, et essaye 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 (lisez l’article ici), je ne suis pas vraiment impressionné par Domoticz, et je comprends mieux les résultats de mon enquête sur la chaîne YouTube :

Je trouve l’installation de Home Assistant plus facile, avec un meilleur site web et une image prête à l’emploi. Ensuite, il y a un assistant de bienvenue qui détecte automatiquement les appareils sur votre réseau, et vous pouvez les ajouter en quelques clics. Et dans l’ensemble, l’interface de Home Assistant est beaucoup plus agréable et intuitive que celle de Domoticz.

HOOBS est une autre bonne alternative que vous pourriez envisager, consultez mon tutoriel ici.

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

FAQ

Où est installé Domoticz sur mon Raspberry Pi ?

Les fichiers de Domoticz sont créés dans votre dossier de projet Docker. Dans ce guide, c’est sous /home/pat/domoticz (changez le chemin pour le dossier personnel de votre utilisateur). Mais vous pouvez le changer lors de l’installation manuelle, et lors du premier lancement du conteneur docker.

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

Comment mettre à jour Domoticz ?

Le moyen le 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 avez utilisé Docker comme expliqué dans ce guide, la mise à jour de Domoticz peut se faire avec Docker Compose. Depuis votre dossier de projet, exécutez :
docker compose pull
docker compose up -d

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