Matériel nécessaire et prérequis pour configurer un module Shelly avec Home Assistant
Avant de débuter la configuration de votre module Shelly avec Home Assistant, il est essentiel de s’assurer que vous disposez de tout le matériel requis ainsi que des connaissances minimales pour une installation réussie. Ce tutoriel s’adresse aux débutants, mais une familiarité de base avec les concepts réseaux et la domotique facilitera grandement la tâche.
Liste du matériel indispensable
- Module Shelly 1 (ou équivalent) : cet interrupteur intelligent est le cœur de votre projet domotique. Il permet de contrôler vos éclairages ou équipements électriques via Wi-Fi.
- Box domotique compatible Home Assistant : un serveur informatique simple comme un Raspberry Pi avec Home Assistant OS installé, ou autre serveur dédié.
- Connexion Wi-Fi stable et sécurisée : le module Shelly communique via votre réseau local, un signal stable est primordial.
- Smartphone ou ordinateur : pour accéder à l’interface Home Assistant et configurer le module.
- Outils d’installation électrique : tournevis isolé, testeur de tension, éventuellement pince coupante pour fixer proprement le module.
- Plan électrique ou schéma de câblage de la pièce où sera installé le module pour respecter les normes de sécurité.
Prérequis logiciels et connaissances de base
Avant d’installer votre module Shelly et l’intégrer à Home Assistant, assurez-vous :
- Que votre Home Assistant est à jour pour profiter des dernières intégrations et correctifs.
- Connaître l’adresse IP de votre réseau local et pouvoir y accéder pour paramétrer vos appareils.
- Comprendre les notions élémentaires de domotique, comme les protocoles Wi-Fi, MQTT (Message Queuing Telemetry Transport) et éventuellement CoIoT, utilisé par certains modules Shelly.
- Avoir une connaissance minimale en électricité, notamment en ce qui concerne les interrupteurs et le câblage, afin d’installer le module Shelly sans risques.
Niveau de difficulté et temps estimé
Le niveau requis est débutant à intermédiaire. La configuration du module ne demande pas de connaissances approfondies en programmation, mais requiert de la rigueur, notamment lors du branchement électrique. Comptez environ 1 à 2 heures pour installer le dispositif et effectuer la configuration complète.
Si vous ne vous sentez pas à l’aise avec l’électricité, il est recommandé de faire appel à un professionnel pour cette étape afin d’assurer votre sécurité et celle de votre habitat.

Procédure pas à pas pour intégrer un module Shelly à Home Assistant
Étape 1 : Préparer et brancher votre module Shelly
La première étape consiste à installer physiquement le module Shelly 1 sur votre interrupteur classique :
- Coupez l’alimentation électrique au niveau du disjoncteur pour travailler en sécurité.
- Retirez l’interrupteur mural concerné en dévissant la plaque et en observant les fils.
- Branchez le module Shelly en respectant le schéma officiel Shelly, c’est-à-dire :
- Phase (L) sur l’entrée spécialement prévue.
- Neutre (N) pour alimenter le module (attention, certains dispositifs ne nécessitent pas le neutre selon l’installation).
- Sortie vers la charge (lampes ou autre appareil à contrôler).
Il est crucial de consulter la documentation propre à votre modèle Shelly, car le câblage peut varier légèrement selon les versions et types d’appareil (Shelly 1, 1PM, 2.5, etc.).
Étape 2 : Connecter le module Shelly à votre réseau Wi-Fi
- Après installation, le module Shelly crée un point d’accès Wi-Fi temporaire.
- Sur votre smartphone ou ordinateur, connectez-vous à ce réseau nommé généralement “shelly1-xxxx”.
- Accédez via un navigateur à l’adresse 192.168.33.1.
- Dans l’interface web, configurez le module en renseignant le SSID et le mot de passe de votre réseau Wi-Fi domestique.
- Validez et attendez que le Shelly se connecte au réseau.
Si vous avez un réseau Wi-Fi avec des configurations avancées, comme un VLAN ou un range extender, assurez-vous que le module obtienne une adresse IP correcte via DHCP et qu’il soit accessible depuis votre Home Assistant.
Étape 3 : Ajouter l’intégration Shelly dans Home Assistant
Une fois le module connecté à votre réseau, l’intégration dans Home Assistant est la suivante :
- Connectez-vous à votre interface Home Assistant.
- Allez dans Paramètres > Appareils et Services.
- Cliquez sur le bouton Ajouter une intégration.
- Recherchez et sélectionnez Shelly dans la liste.
- Si le module est détecté automatiquement dans la section “Discovered”, sélectionnez-le et terminez la procédure.
- Sinon, ajoutez l’adresse IP du module manuellement.
- Sauvegardez les paramètres, l’appareil doit apparaître dans votre interface avec ses entités prêtes à l’emploi.
Étape 4 : Configurer les paramètres avancés pour un contrôle optimal
Certains modules Shelly proposent des options supplémentaires que vous pouvez activer via leur interface web ou directement dans Home Assistant :
- Activation du protocole CoIoT : essentiel pour obtenir des mises à jour en temps réel et une communication plus fluide.
- Réglage des notifications Push pour suivre la consommation électrique (notamment avec Shelly 1PM).
- Configuration des WebSocket pour les générations plus récentes afin de bénéficier d’un contrôle instantané et fiable.
- Option WiFi Client AP Roaming pour assurer une meilleure connexion en cas de multi-points d’accès.
Ces paramètres contribuent à une expérience plus réactive et stable au sein de votre Smart Home.
| Génération de module Shelly | Protocole recommandé | Principales fonctionnalités | Compatibilité Home Assistant |
|---|---|---|---|
| Génération 1 | CoIoT | Mises à jour en temps réel, contrôle Wi-Fi simple | Complète et stable |
| Génération 2 et suivantes | RPC, WebSocket | Contrôle plus fluide, statistiques avancées | Requiert parfois une configuration WebSocket additionnelle |
Étape 5 : Créer vos premières automatisations avec le module Shelly dans Home Assistant
Le vrai potentiel de cette intégration se dévoile avec les automatisations. Voici un exemple simple pour débuter :
- Automatiser l’allumage de la lumière au coucher du soleil.
- Allumer ou éteindre les lampes en fonction de la présence détectée dans une pièce (avec un capteur compatible).
- Envoyer une notification sur votre smartphone si une lampe reste allumée tard la nuit.
Générez vos scénarios en suivant ces étapes :
- Dans Home Assistant, rendez-vous dans Configuration > Automations & Scènes.
- Cliquez sur Ajouter une automatisation.
- Choisissez un déclencheur, par exemple un horaire ou un événement sur le module Shelly.
- Définissez l’action, par exemple allumer le relais du module Shelly.
- Donnez un nom clair et sauvegardez.
Ces commandes personnalisées vous permettent d’adapter la domotique à votre mode de vie.
Dépannage courant et conseils pour une configuration efficace du module Shelly avec Home Assistant
Problèmes fréquents rencontrés
- Module Shelly non détecté dans Home Assistant : assurez-vous que le module est bien connecté au même réseau Wi-Fi que Home Assistant et que le protocole CoIoT est activé.
- Latence ou absence de remontée d’informations : vérifiez la qualité du signal Wi-Fi, activez Client AP Roaming si disponible, et redémarrez le module.
- Automatisations ne fonctionnant pas : contrôlez la logique des déclencheurs et actions, testez manuellement les entités Shelly depuis l’interface.
- Erreur de câblage électrique : si l’interrupteur ne fonctionne pas ou que l’appareil chauffe, coupez immédiatement l’alimentation et revérifiez le câblage selon les schémas officiels ou faites appel à un professionnel.
Bonnes pratiques et astuces terrain
- Persistez à nommer clairement chaque appareil et entité dans Home Assistant pour éviter toute confusion lors de la création d’automatisations.
- Utilisez la fonction de sauvegarde de configuration Home Assistant pour conserver vos réglages avant de faire des modifications majeures.
- Organisez votre dashboard Home Assistant en regroupant vos modules Shelly par pièce ou fonction pour un accès rapide.
- Mettez régulièrement à jour le firmware de vos modules Shelly via l’application Shelly Cloud pour profiter des correctifs et nouvelles fonctionnalités.
- Activez l’authentification sur Home Assistant pour sécuriser votre installation, notamment si vous accédez à distance.
Compatibilité et intégration des modules Shelly avec d’autres systèmes domotiques
Les modules Shelly sont réputés pour leur grande compatibilité avec plusieurs systèmes de Smart Home, grâce notamment à leur connexion Wi-Fi et la prise en charge de protocoles standards comme MQTT.
Outre Home Assistant, voici quelques plateformes où l’intégration est optimisée :
- Jeedom : plugins dédiés Shelly permettent une gestion similaire avec interface personnalisée.
- Homey : prise en charge via applications Shelly et pilotage par assistants vocaux.
- Alexa et Google Home : les modules Shelly peuvent être découverts et contrôlés, facilitant la commande vocale.
- Apple HomeKit : via des passerelles compatibles, l’intégration devient possible.
Pour maximiser la cohérence de votre système, il est pertinent de vérifier la version du firmware et les possibilités d’intégration disponibles à la date d’installation.
Protocoles utilisés par les modules Shelly
Selon la génération du module, le protocole varie :
- Wi-Fi natif : permet une communication directe dans un réseau local.
- CoIoT : protocole légé Shelly pour optimiser la communication interne en local, réduisant la latence.
- MQTT : un protocole de messagerie très utilisé dans la domotique, assurant l’échange fiable des données entre l’appareil et le serveur Home Assistant.
| Plateforme domotique | Méthode d’intégration | Fonctionnalités clés | Limites / particularités |
|---|---|---|---|
| Home Assistant | Intégration directe Shelly via IP & CoIoT / WebSocket | Mise à jour en temps réel, automatisations avancées, dashboards personnalisés | Nécessite une configuration réseau correcte, parfois un réglage WebSocket |
| Jeedom | Plugins Shelly avec API | Commandes locales, statistiques détaillées | Interface souvent plus complexe pour débutants |
| Amazon Alexa / Google Home | Détection automatique via cloud | Commande vocale simple, scénarios liés à l’assistant | Dépendance au cloud, latence possible |
Exemples concrets : scénarios d’automatisation avec module Shelly et Home Assistant
Découvrez quelques scénarios pour exploiter tout le potentiel de votre module Shelly dans un environnement Home Assistant :
1. Allumer la lumière du salon au coucher du soleil
Créez une automatisation qui s’active dès que le soleil se couche :
- Définissez dans Home Assistant un déclencheur temporel basé sur l’entité sun.sun avec l’état below_horizon.
- Ajoutez une action pour allumer la lampe connectée au module Shelly.
- Programmez un autre scénario pour éteindre la lumière à une heure précise, par exemple minuit.
2. Allumer la lumière automatiquement en entrant dans une pièce
Associez un capteur de présence compatible (PIR) à votre module Shelly :
- Sélectionnez le capteur comme déclencheur, détectant la présence.
- Programmez une action pour activer la lumière via le relais Shelly.
- Ajoutez un délai pour l’extinction automatique si aucune présence n’est détectée.
3. Suivi et alerte de consommation électrique
Avec le module Shelly 1PM, suivez votre consommation en temps réel :
- Configurez une surveillance via Home Assistant pour relever la puissance absorbée.
- Créez une alerte si une consommation anormale est détectée (exemple : appareil resté allumé).
- Recevez une notification sur votre smartphone pour intervenir rapidement.

