Installer Jeedom avec Zigbee2MQTT : guide détaillé

Mettre en place Jeedom et piloter tous vos appareils Zigbee via Zigbee2MQTT

Jeedom est la principale solution domotique française, très appréciée pour sa richesse fonctionnelle et sa communauté active. Couplé à Zigbee2MQTT, il permet de contrôler l’ensemble du marché Zigbee sans dépendance aux écosystèmes propriétaires. Ce guide vous mène de l’installation à votre premier scénario.

Matériel nécessaire

Serveur Jeedom	Raspberry Pi 4 (2 Go RAM minimum), Jeedom Smart, ou PC Linux
Carte SD / SSD	Carte microSD 32 Go classe 10, ou SSD USB pour plus de fiabilité
Clé USB Zigbee	SONOFF Zigbee 3.0 USB Dongle Plus ou équivalent CC2652P recommandé
Connexion réseau	Connexion filaire (Ethernet) fortement recommandée pour Jeedom
Alimentation	Alimentation officielle Raspberry Pi 4 (5V/3A minimum)

Installation de Jeedom

Méthode 1 : image Jeedom sur Raspberry Pi

Téléchargez l’image officielle Jeedom sur jeedom.com > Espace Téléchargement
Flashez l’image sur la carte SD avec Raspberry Pi Imager ou Balena Etcher
Insérez la carte SD dans le Raspberry Pi
Connectez le Pi en Ethernet à votre box et branchez l’alimentation
Attendez 5 minutes le premier démarrage (expansion du système de fichiers)
Accédez à http://jeedom.local ou l’adresse IP du Pi depuis votre navigateur

Méthode 2 : installation sur Debian/Ubuntu existant

Connectez-vous en SSH à votre serveur
Exécutez le script d’installation officiel :

💻 COMMANDE INSTALLATION

wget -O install_jeedom.sh https://raw.githubusercontent.com/jeedom/core/alpha/install/install.shsudo bash install_jeedom.sh

L’installation dure environ 15 à 30 minutes selon la connexion
Accédez à http://[ip-serveur] une fois l’installation terminée

Configuration initiale de Jeedom

Choisissez la langue (Français) et créez votre compte administrateur
Entrez votre numéro de licence (gratuit pour usage personnel avec compte jeedom.com)
Laissez Jeedom vérifier les mises à jour et les installer
Explorez le tableau de bord vide : c’est ici que tout va s’organiser

Installation du broker MQTT (Mosquitto)

Zigbee2MQTT communique via le protocole MQTT. Vous avez besoin d’un broker MQTT – Mosquitto est le plus utilisé.

Installation via le plugin Jeedom MQTT Manager

Dans Jeedom : Plugins > Gestion des plugins > Market
Recherchez « MQTT Manager » et installez-le (gratuit)
Activez le plugin et allez dans sa configuration
Choisissez « Installer le broker local Mosquitto »
Notez les identifiants générés (login/mot de passe MQTT) – ils vous seront demandés plus tard

🔑 IDENTIFIANTS MQTT
Conservez précieusement les identifiants MQTT générés. Ils sont nécessaires à la fois pour Zigbee2MQTT et pour la configuration du plugin Jeedom. En cas de perte, vous pouvez les régénérer dans la configuration du plugin

Installation de Zigbee2MQTT

Préparer la clé USB Zigbee

Branchez la clé USB Zigbee sur le Raspberry Pi
Identifiez le port USB assigné en SSH :

💻 IDENTIFIER LE PORT USB

ls /dev/serial/by-id/# Vous verrez quelque chose comme :# usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_xxx-if00-port0

Notez le chemin complet affiché – il sera utilisé dans la configuration Z2M

Installation de Zigbee2MQTT

💻 INSTALLATION NODE.JS

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt-get install -y nodejs git make g++ gcc

💻 INSTALLATION Z2M

sudo mkdir /opt/zigbee2mqttsudo chown -R ${USER}: /opt/zigbee2mqttgit clone --depth 1 https://github.com/Koenkk/zigbee2mqtt.git /opt/zigbee2mqttcd /opt/zigbee2mqtt && npm ci

Configuration de Zigbee2MQTT

Créez le fichier de configuration /opt/zigbee2mqtt/data/configuration.yaml :

homeassistant: false
frontend:
  port: 8080
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://localhost:1883
  user: [votre-login-mqtt]
  password: [votre-mot-de-passe-mqtt]
serial:
  port: /dev/serial/by-id/[votre-clé-usb]
channel: 25

Démarrez Zigbee2MQTT pour tester : cd /opt/zigbee2mqtt && npm start
Accédez à l’interface web : http://[ip-jeedom]:8080

Configurer Z2M comme service système

Créez le service systemd pour que Z2M démarre automatiquement au boot
Activez et démarrez le service : sudo systemctl enable zigbee2mqtt && sudo systemctl start zigbee2mqtt

Connecter Jeedom à Zigbee2MQTT

Installer le plugin Zigbee2MQTT pour Jeedom

Dans Jeedom : Plugins > Gestion des plugins > Market
Recherchez « Zigbee2MQTT » (plugin officiel communautaire)
Installez et activez le plugin
Allez dans la configuration du plugin
Renseignez les paramètres MQTT : hôte localhost, port 1883, login/password
Sauvegardez et attendez la connexion (statut vert)

Ajouter votre premier appareil Zigbee

Dans le plugin Z2M de Jeedom, activez le mode appairage (Permit Join)
Passez votre appareil Zigbee en mode reset (voir notice fabricant)
L’appareil apparaît dans Z2M et est automatiquement créé dans Jeedom
Renommez l’appareil et assignez-le à une pièce dans Jeedom
Les commandes (on/off, niveau, température…) sont automatiquement disponibles

ℹ️ CONCEPT CLÉ
Jeedom organise les appareils en « équipements » avec des « commandes ». Chaque commande correspond à une action (allumer) ou une information (température). C’est le concept central de Jeedom.

Créer votre premier scénario

Les scénarios Jeedom sont l’équivalent des automatisations Home Assistant. Pour créer un allumage automatique la nuit :

Allez dans Outils > Scénarios > Ajouter
Mode : Provoqué (déclenché par un événement)
Déclencheur : sélectionnez votre capteur de mouvement, événement « présence détectée »
Condition : heure entre 22h00 et 07h00
Action : allumer la lampe du couloir à 15 %
Action avec délai : 3 minutes plus tard, éteindre la lampe
Activez et testez le scénario

Application mobile	L’app Jeedom (iOS/Android) donne accès complet à distance
Communauté	Forum community.jeedom.com avec des milliers de tutoriels en français
Market Jeedom	Plus de 300 plugins disponibles pour enrichir votre installation
Support	Documentation complète sur doc.jeedom.com