Installer Domoticz - Le guide complet pour une domotique stable

Choisir la méthode qui correspond à votre installation

Je vois quatre scénarios qui reviennent sans cesse. Pour un serveur Linux ou un mini-PC dédié, l’installation précompilée reste la plus directe. Pour une maison déjà découpée en conteneurs, Docker simplifie la maintenance. La compilation source n’a de sens que pour un besoin très spécifique, et Windows ou macOS servent surtout à tester ou à dépanner, pas à bâtir le cœur de l’installation.

Domoticz garde un intérêt réel parce qu’il couvre un spectre matériel large, avec plus de 150 types de périphériques pris en charge, du Zigbee au Z-Wave en passant par MQTT. Dans la pratique, je recommande surtout un Linux dédié ou un Raspberry Pi bien préparé, avec stockage fiable et alimentation correcte. Une fois la méthode choisie, je vérifie toujours l’état de la machine, parce que les ratés commencent souvent avant même le lancement.

Préparer la machine avant de lancer Domoticz

Avant d’installer quoi que ce soit, je m’assure que la machine ne va pas me saboter plus tard. L’heure système doit être correcte, le réseau stable, et l’espace de configuration persistant. C’est particulièrement vrai sur Raspberry Pi, où une microSD fatiguée ou une horloge non synchronisée peut produire des scénarios très pénibles à diagnostiquer.

• Je pars d’un système à jour et d’une connexion réseau stable.
• Je fixe une adresse IP ou au moins une réservation DHCP pour éviter de courir après la box.
• Je vérifie l’heure et la synchronisation NTP, parce que la programmation horaire repose dessus.
• Si j’utilise un dongle série, je liste les périphériques avec ls /dev/serial/by-id.
• Sur Linux, j’ajoute l’utilisateur au groupe dialout si nécessaire avec sudo usermod -a -G dialout votre_utilisateur.
• Je garde Domoticz sur le port 8080 au départ; forcer le port 80 apporte rarement un vrai bénéfice au début.

Sur un Pi, je préfère aussi un SSD USB à une microSD dès que l’installation doit durer. Le gain n’est pas spectaculaire le premier jour, mais il change beaucoup de choses au bout de quelques mois. Avec cette base propre, l’installation native devient presque mécanique.

Installer Domoticz sur Linux avec le script officiel

Sur un Linux récent, je recommande l’installation précompilée tant que vous n’avez pas besoin de modifier le code. Elle évite la compilation, limite les dépendances à gérer et suffit dans la majorité des cas pour un serveur domotique de maison.

1. Lancez l’installateur officiel fourni par Domoticz sur votre distribution compatible.
2. Répondez aux questions sur le service web, le port et l’activation éventuelle de HTTPS.
3. Vérifiez que le service démarre automatiquement après le boot.
4. Ouvrez l’interface web sur le port choisi, en général 8080 au départ.
5. Gardez un compte administrateur robuste et remplacez immédiatement les identifiants par défaut s’ils sont proposés.

Je laisse généralement le port 8080 pendant la mise en route, puis je ne passe sur 80 ou 443 qu’en connaissance de cause, souvent derrière un proxy inversé si l’accès doit sortir du réseau local. Pour une installation de salon ou de garage, cette sobriété évite pas mal de complications inutiles. Une fois cette version en place, le cas Docker mérite d’être regardé si votre maison est déjà conteneurisée.

Installer Domoticz avec Docker quand on veut garder la main

Docker n’est pas indispensable, mais il devient vite logique dès qu’on veut séparer proprement l’application, ses dépendances et les autres briques de la maison connectée. J’aime cette option quand Mosquitto, Zigbee2MQTT ou Z-Wave JS UI tournent déjà dans des conteneurs distincts, parce qu’on maîtrise mieux les mises à jour et les retours arrière.

• Je persiste le dossier de configuration dans un volume nommé ou un répertoire local.
• Je mappe le port de l’interface, souvent 8080:8080.
• J’ajoute les périphériques série explicitement via /dev/serial/by-id/....
• Je vérifie que docker compose est bien installé et que l’équipe sait maintenir les volumes.
• Si je veux créer l’utilisateur admin automatiquement, j’utilise les variables DOMOTICZ_ADMIN_USERNAME et DOMOTICZ_ADMIN_PASSWORD quand elles sont supportées.

Le point à ne pas rater, c’est la persistance. Un conteneur sans volume bien monté n’est qu’une coquille vide à la prochaine mise à jour. Je préfère aussi nommer proprement les périphériques USB depuis le début, parce qu’un dongle radio qui change de port après redémarrage peut bloquer une installation entière. Quand la couche d’exécution est propre, le premier écran devient beaucoup plus simple à lire.

Faire le premier démarrage proprement

Au premier lancement, Domoticz ouvre un assistant de configuration. C’est le moment où je règle tout ce qui conditionne la suite: compte administrateur, langue, fuseau horaire, localisation et comportement général de l’interface. Si on bâcle cette étape, on se retrouve avec des scénarios qui déclenchent au mauvais moment ou des horaires décalés d’une heure.

1. Créez le compte administrateur et changez immédiatement tout mot de passe par défaut.
2. Renseignez le fuseau horaire et la localisation, parce que la logique jour/nuit dépend de ces paramètres.
3. Vérifiez le port et le mode d’exposition de l’interface si la box doit rester accessible depuis le réseau local ou à distance.
4. Choisissez un thème lisible et gardez une structure de nommage simple pour les pièces et les équipements.
5. Si vous déployez en Docker, préparez les variables d’environnement avant le premier démarrage plutôt que de corriger après coup.

J’apprécie aussi le fait que l’interface web soit pensée pour rester utilisable sur ordinateur comme sur mobile, parce que dans une maison on consulte souvent l’état d’un capteur depuis le téléphone, sans ouvrir un poste fixe. Une fois l’interface saine, il reste le vrai cœur du sujet: intégrer les passerelles et les capteurs.

Ajouter les passerelles et les modules sans se tromper

Dans Domoticz, je procède toujours dans le même ordre: j’ajoute la passerelle dans Setup > Hardware, j’attends que les entités remontent, puis je les active dans Setup > Devices. Cette discipline évite l’écueil classique du débutant qui cherche ses capteurs au mauvais endroit ou importe trop vite sans vérifier la source.

Je suis plus prudent avec les plugins qu’avec le matériel supporté nativement: ils rendent service, mais ils ajoutent une couche de dépendance à surveiller. Pour une maison française typique, je commence souvent par l’éclairage du salon, un ou deux volets roulants et un capteur de température, puis je monte en complexité seulement après avoir validé la stabilité. Une fois le matériel en place, la vraie différence se joue dans la maintenance et les sauvegardes.

Faire durer l’installation sans mauvaise surprise

Une installation domotique ne doit pas seulement démarrer, elle doit tenir. Je privilégie les mises à jour mesurées, les sauvegardes avant changement et une vérification rapide après chaque évolution matérielle. C’est beaucoup moins spectaculaire qu’une automatisation sophistiquée, mais c’est ce qui garde la maison pilotable quand un dongle USB change de port ou qu’un plugin cesse de répondre.

• Je sauvegarde la configuration avant chaque mise à jour importante.
• Je garde l’heure système correcte, surtout si la machine peut fonctionner hors ligne ou redémarrer souvent.
• Je limite les droits au strict nécessaire, y compris pour l’accès aux ports série.
• Je surveille les journaux après l’ajout d’un équipement ou d’une passerelle.
• Je teste chaque scénario critique, par exemple chauffage, alarme, éclairage extérieur ou fermeture des volets, après modification.