Intégrer un relais Shelly à Home Assistant (API locale, sans cloud)

  • domotique, home assistant, shelly, wifi
Relais Shelly installé derrière un interrupteur et intégré à Home Assistant en local
Comment ajouter un relais Shelly (Plus 1, 1PM, Plug S) à Home Assistant via son intégration native, en 100% local et sans passer par le cloud Shelly : étapes, entités créées et limites à connaître.

Sommaires

Tu veux piloter une lumière, une VMC ou un chauffe-eau depuis Home Assistant, mais tu n’as pas envie d’ajouter une clé Zigbee ou de dépendre d’une appli cloud en plus ? Les relais Shelly sont une des options les plus citées pour ça : ils se connectent en WiFi directement à ta box et Home Assistant les intègre nativement, sans passer par le cloud Shelly. Dans cet article, je t’explique comment les ajouter à ton installation et ce que tu récupères comme entités une fois branché.

Ce guide est basé sur la documentation officielle Home Assistant et les retours de la communauté — je n’ai pas testé ça moi-même, donc n’hésite pas à confirmer certains détails avec ton propre setup.

🎯 C’est quoi, concrètement, un relais Shelly ?

Un Shelly, c’est un petit module électronique qui se câble derrière un interrupteur, une prise ou un appareil électrique, et qui ajoute une commande WiFi dessus. Contrairement aux prises connectées Zigbee (comme l’IKEA TRETAKT), un Shelly ne passe pas par un coordinateur Zigbee2MQTT ou ZHA : il se connecte en direct sur ton réseau WiFi, un peu comme une prise TP-Link Tapo.

Les modèles les plus courants pour débuter :

  • Shelly 1 / Shelly Plus 1 : un relais « sec » à encastrer derrière un interrupteur mural, pour piloter une lumière ou un volet roulant filaire. Le Plus 1 est la version de génération 2 (protocole RPC, plus fiable et plus rapide à intégrer).
  • Shelly 1PM / Shelly Plus 1PM : la même chose, mais avec un capteur de puissance intégré (le « PM » veut dire Power Metering).
  • Shelly Plug S : une prise connectée classique, à brancher directement, avec mesure de consommation.

🧩 Pourquoi passer par l’intégration native plutôt que le cloud Shelly ?

Shelly propose une appli et un compte cloud pour piloter tes appareils depuis l’extérieur. Mais si ton seul objectif est de tout centraliser dans Home Assistant, tu n’en as pas besoin : l’intégration officielle Shelly de Home Assistant parle directement à l’appareil sur ton réseau local, en HTTP/WebSocket selon la génération. Résultat : pas de compte à créer, pas de dépendance à un serveur distant, et des temps de réponse quasi instantanés puisque tout reste sur ton réseau local.

C’est le même principe que pour une prise Tapo : les deux marques permettent un contrôle 100 % local en WiFi, sans coordinateur Zigbee à gérer.

🔧 Ajouter ton Shelly à Home Assistant

Avant de commencer, configure ton Shelly sur ton réseau WiFi via son appli mobile ou son point d’accès local (il en crée un temporairement à la première mise sous tension). Une fois qu’il a une IP sur ton réseau :

  1. Va dans Paramètres > Appareils et services.
  2. Home Assistant devrait afficher une notification « Découvert » si le Shelly est déjà sur le même réseau — clique sur Configurer.
  3. S’il n’est pas détecté automatiquement, clique sur Ajouter une intégration, cherche « Shelly », puis renseigne l’adresse IP (ou le nom d’hôte) du module, visible dans l’interface de ta box ou dans l’appli Shelly.
  4. Si tu as mis un identifiant/mot de passe sur le Shelly (recommandé pour la sécurité), Home Assistant te les demandera à cette étape.
  5. Valide, choisis la pièce, et l’appareil apparaît dans ta liste avec ses entités.

Petit conseil qui revient souvent dans les retours de la communauté : réserve une IP fixe pour ton Shelly dans ta box (réservation DHCP). Si son adresse change, Home Assistant peut perdre le contact et afficher l’entité comme indisponible.

Pour les modules de génération 1 (Shelly 1, Shelly Plug S première version), il faut aussi activer le protocole CoIoT dans les réglages du module (menu Internet & Security > réglages développeur avancés), sinon les états ne remontent pas en temps réel.

⚡ Les entités que tu récupères

Une fois l’appareil ajouté, tu obtiens généralement :

  • Une entité switch. pour piloter le relais (allumer/éteindre).
  • Sur les modèles « PM » (1PM, Plug S) : un ou plusieurs sensor. de puissance instantanée (W) et de consommation cumulée (kWh).
  • Des capteurs diagnostiques : force du signal WiFi, uptime, température interne du module.
  • Une entité update. qui t’indique si une mise à jour firmware est disponible.

Ces entités de suivi de consommation peuvent venir compléter ce que tu as déjà en place avec un suivi Linky ou une Écojoko, en te donnant le détail appareil par appareil plutôt qu’une vue globale du logement.

👉 Exemple d’automatisation simple

Une automatisation basique pour éteindre un Shelly automatiquement si sa consommation reste proche de zéro pendant 15 minutes (utile pour un appareil qu’on oublie souvent allumé, un chargeur ou une multiprise) :

alias: "Éteindre le Shelly si inactif"
trigger:
  - platform: numeric_state
    entity_id: sensor.shelly_1pm_power
    below: 3
    for:
      minutes: 15
condition: []
action:
  - service: switch.turn_off
    target:
      entity_id: switch.shelly_1pm

Adapte les noms d’entités sensor.shelly_1pm_power et switch.shelly_1pm à ceux générés chez toi (ils dépendent du nom donné à l’appareil pendant la configuration).

📲 Limites à connaître

  • Le Shelly reste un appareil WiFi : plus tu en ajoutes, plus tu charges ton réseau et ta box, contrairement au Zigbee qui forme un maillage indépendant.
  • Les modules de génération 1 ont des limitations de firmware et un protocole (CoIoT) moins robuste que le RPC des générations 2 et 3 — privilégie les modèles « Plus » ou « Gen3 » si tu achètes aujourd’hui.
  • Certains modèles très anciens (Gen 1 « 4Pro » et « Sense ») ne sont pas supportés par l’intégration officielle.
  • Les appareils sur batterie (capteurs Shelly BLU) ne passent pas par cette intégration mais par l’intégration BTHome, et doivent être réveillés manuellement pour être détectés.
  • Comme pour tout appareil WiFi, une coupure de box coupe aussi la main sur tes relais depuis Home Assistant (même si l’état physique du relais, lui, ne change pas).

💧 Pour aller plus loin

Avant d’ajouter plusieurs appareils WiFi et Zigbee dans la même installation, ça vaut le coup de comparer les deux approches — j’en parle dans mon article sur Zigbee2MQTT vs ZHA, ou dans ma comparaison entre une prise Shelly et une prise TP-Link Tapo, deux solutions WiFi/locales assez proches dans leur logique. Et si tu veux transformer les données de puissance récupérées par ton Shelly en vrai suivi de conso, direction mon guide sur le suivi de consommation électrique avec Home Assistant.

Découvre également