Shelly a publié la semaine dernière, le 11 novembre 2026, le firmware 2.2.0 stable pour toute la gamme Gen2 et générations supérieures. Et si on en parle sur domo-blog aujourd’hui, c’est parce que ce n’est pas qu’une simple mise à jour corrective. Riche en fonctionnalités locales utiles, elle ajoute des fonctions très attendues comme la sauvegarde de configuration, un délai de remise sous tension par sortie, la découverte réseau mDNS entre Shelly et deux nouveaux appels RPC pour piloter plusieurs relais d’un coup, rien que ça !
Pour celui qui, comme moi, pilote ses Shelly en local depuis Home Assistant, ces nouveautés ont vraiment du sens. Elles renforcent l’autonomie des modules sur le LAN et simplifient la reprise après coupure. Et elles offrent enfin une vraie stratégie de sauvegarde, jusque-là absente.
Prérequis pour suivre cet article
- un ou plusieurs modules Shelly Gen2, Gen3 ou Gen4
- un accès local à l’API RPC (
http://ip_du_shelly/rpc), idéalement protégé par mot de passe - Home Assistant avec l’intégration Shelly native, ou au minimum
curlsur une machine du réseau (NAS ou PC)
Ce qu’il faut savoir avant de mettre à jour
La 2.2.0 est arrivée en stable un mois après la beta 2.2.0-beta1 publiée le 15 octobre dernier. Elle succède donc à la 2.1.0 du 14 octobre, qui n’apportait que la prise en charge du service cloud NILM de Shelly. La 2.2.0 est donc la première grosse release fonctionnelle depuis la 2.0.0 de juillet.

Shelly le rappelle dans son changelog que tous les modules ne reçoivent pas les mêmes mises à jour. Deux nouveautés sont même réservées à une partie de la gamme, faute de place en flash.
| Fonction | Disponible sur | Exclus |
|---|---|---|
| Sauvegarde et configuration par défaut | Gen3, Gen4, Gen2 encore produits | Plus Uni, Plus RGBW PM, EM Gen4 et 2PM Gen4 en firmware Zigbee |
Découverte mDNS (Sys.StartDiscovery) | Gen3, Gen4, Gen2 encore produits | Gen4 en firmware Zigbee (ils restent découvrables par les autres) |
Délai de remise sous tension, Switch.SetAll | Tout module à sortie relais | — |
Switch.SetMany | Modules à plusieurs sorties (Pro 4PM, Power Strip 4 Gen4…) | Modules mono-sortie |
Sauvegarde de configuration : enfin un vrai filet de sécurité
C’est la nouveauté la plus utile de cette version. Jusqu’ici, un module défaillant ou réinitialisé obligeait à tout reconfigurer à la main : scripts, webhooks, profils, protections, MQTT. Le firmware 2.2.0 sait désormais produire une archive complète du système de fichiers du module, et la restaurer.

Deux points à connaître :
- le chiffrement est optionnel mais recommandé. L’archive contient les mots de passe Wi-Fi, les jetons cloud et les clés Matter. Avec
encrypt=true, le module chiffre en AES-128 et renvoie une clé une seule fois : perdue, la sauvegarde est inutilisable ; - l’export est bloqué pendant la mise en service. Tant que le module est en état de provisioning
pendingouconfirmed, la création et le téléchargement renvoient une erreur (503 pour /backup.zip).
Le script de sauvegarde, pour rappatrier la config sur un NAS
Plus pratique que la sauvegarde manuelle à la demande. Une programmation via une tâche planifiée permet d’avoir une routine automatique récurrente pour exporter les sauvegardes des modules vers un NAS ou un PC. Ce script sauvegarde un module de bout en bout. Il se lance depuis un conteneur LXC, un serveur physique ou directement sur un NAS Synology via le planificateur de tâches. C’est comme cela que je l’utilise chez moi.
#!/usr/bin/env bash
# Sauvegarde chiffrée d'un Shelly Gen2+ (firmware >= 2.2.0)
set -euo pipefail
IP="192.168.10.50"
USER="admin" # utilisateur fixe de l'API Shelly
PASS="${SHELLY_PASS:?Variable SHELLY_PASS absente}"
DEST="/volume1/backup/shelly" # partage NAS cible
RPC="http://${IP}/rpc"
# 1. Programme la sauvegarde chiffrée ; la réponse contient la clé AES
KEY=$(curl -sf --digest -u "${USER}:${PASS}" "${RPC}/Sys.CreateBackup?encrypt=true" | jq -r '.key')
# 2. Redémarre : l'archive est générée au boot (pas de power_restore_delay sur un reboot logiciel)
curl -sf --digest -u "${USER}:${PASS}" "${RPC}/Shelly.Reboot" > /dev/null
sleep 45
# 3. Récupère l'archive et stocke la clé à côté, avec des droits restreints
STAMP=$(date +%F)
curl -sf --digest -u "${USER}:${PASS}" -o "${DEST}/${IP}_${STAMP}.zip" "http://${IP}/backup.zip"
printf '%s\n' "${KEY}" > "${DEST}/${IP}_${STAMP}.key"
chmod 600 "${DEST}/${IP}_${STAMP}.key"
```
1. Pour faire fonctionner ce script, vous devrez l’adapter à votre configuration mais aussi activer l’authentification sous la page web du module Shelly dans Settings/Authentication

2. Puis créer un fichier shelly.env sur le Synology avec le mot de passe dedans, le tout restreint à l’utilisateur qui exécute la tâche uniquement pour un processus sécurisé.
3. Programmez ensuite la tâche planifiée sous le Synology en utilisant la ligne qui appelle le script backup_shelly.sh et vient lire le fichier shelly.env
source /volume1/scripts/.shelly.env && /volume1/scripts/backup_shelly.sh
4. Le redémarrage applique l’initial_state de chaque sortie. Planifiez donc la sauvegarde à un moment où un bref basculement du relais ne gêne pas, surtout sur un module en restore_last qui pilote un équipement sensible.
5. Le resultat une fois sous une tâche Synology, vous obtenez des sauvegardes regulières externalisées.

Restaurer une sauvegarde
La restauration se fait en deux temps : envoi de l’archive par morceaux avec Sys.UploadBackup, puis Sys.RestoreBackup avec la clé. Le module efface son système de fichiers et redémarre immédiatement sur la configuration restaurée. L’upload reste autorisé pendant la mise en service, ce qui permet de restaurer un module neuf ou réinitialisé avant même de l’avoir configuré.

Pas besoin d’automatisation ici, puisque la restauration ne sera à effectuer qu’en cas de problème. Il faudra alors récupérer l’archive correspondant au module à restaurer sur le NAS, puis l’envoyer vers le module via l’application ou le serveur web local.
Configuration par défaut personnalisée
La seconde brique vise surtout les installateurs. Sys.CreateDefaultConfig fige la configuration actuelle comme « réglages d’usine ». Après chaque réinitialisation, le module réapplique automatiquement cette configuration au lieu de repartir de zéro. C’est une fonction qui peut aussi s’avérer pratique, même si une sauvegarde permet déjà d’en restaurer l’état.
L’emplacement est protégé par un mot de passe défini au premier appel. Si ce mot de passe est perdu, un appui de 30 secondes sur le bouton système efface la configuration par défaut puis réinitialise le module. Cette porte de sortie ne peut pas être désactivée.
En usage domestique, l’intérêt est concret : une configuration de base (Wi-Fi, MQTT, mot de passe API, désactivation du cloud) qui survit à une réinitialisation accidentelle.
Délai de remise sous tension : échelonner le redémarrage après coupure
Une autre nouveauté est la possibilité d’appliquer un délai au démarrage. Après une coupure secteur, tous les Shelly redémarrent en même temps et réappliquent leur initial_state dans la même seconde. Pompe de chauffage, chauffe-eau, VMC et prises de serveurs repartent donc ensemble, au pire moment : réseau encore instable et pic d’appel de courant. Le nouveau paramètre power_restore_delay retarde cette remise en route, sortie par sortie.
Ce que fait exactement le délai
Le réglage repose sur deux clés de Switch.SetConfig :
power_restore_delay_enable: active ou désactive la fonction (désactivée par défaut) ;power_restore_delay: la durée, de 1 à 600 secondes, 60 par défaut.
Le délai ne s’applique que dans un cas précis. Il faut une vraie coupure d’alimentation, et que l’état de démarrage prévu soit allumé : on, restore_last avec une sortie qui était allumée, ou match_input. Il ne joue pas après un Shelly.Reboot, une mise à jour OTA, une réinitialisation, un plantage ou un watchdog.
Pendant le compte à rebours, la sortie reste éteinte et Switch.GetStatus expose un timer timer_type: power_restore_delay. À l’expiration, le changement d’état porte la source power_restore_delay, ce qui permet de le distinguer dans un historique Home Assistant. Toute commande explicite reçue pendant ce temps annule le délai et s’exécute normalement, qu’elle vienne de HA, d’un interrupteur, d’un script ou de MQTT.
En mode match_input, l’entrée physique est lue à la fin du délai, pas au démarrage. Si quelqu’un a basculé l’interrupteur mural pendant la coupure, la sortie suivra donc sa position réelle.
Configurer un échelonnement sur plusieurs modules
L’intérêt maximal vient d’un délai différent par module. Ce script affecte 30, 60, 90 secondes… à une liste de Shelly, dans l’ordre de priorité de redémarrage :
#!/usr/bin/env bash
# Échelonne la reprise après coupure : +30 s par module, dans l'ordre de la liste
set -euo pipefail
USER="admin"
PASS="${SHELLY_PASS:?Variable SHELLY_PASS absente}"
DELAY=30
# Ordre = priorité : la box et le switch d'abord, le chauffe-eau en dernier
for IP in 192.168.10.50 192.168.10.51 192.168.10.52; do
# Payload JSON-RPC construit avec jq pour éviter les problèmes d'échappement
PAYLOAD=$(jq -nc --argjson d "${DELAY}" '{
id: 1, method: "Switch.SetConfig",
params: { id: 0, config: {
initial_state: "restore_last",
power_restore_delay_enable: true,
power_restore_delay: $d } } }')
curl -sf --digest -u "${USER}:${PASS}" -H 'Content-Type: application/json' \
-d "${PAYLOAD}" "http://${IP}/rpc" > /dev/null
echo "${IP} : délai de ${DELAY} s"
DELAY=$((DELAY + 30))
done
Sur un module multi-sorties comme un Pro 4PM, chaque sortie a son propre compte à rebours : il faut répéter l’appel avec id: 0 à id: 3.
Pensez enfin à la cohérence avec Home Assistant. Une automatisation qui rallume tout au retour de HA annulera les délais en cours, puisque toute commande explicite les interrompt.
Switch.SetAll et Switch.SetMany : plusieurs sorties en un seul appel
Sur un Pro 4PM ou une Power Strip 4 Gen4, couper trois sorties depuis Home Assistant revenait jusqu’ici à envoyer trois commandes successives. La 2.2.0 ajoute deux méthodes qui font le travail en une seule requête, côté module :
Switch.SetAllagit sur toutes les sorties de l’appareil ;Switch.SetManyagit sur une liste de sorties (ids), uniquement sur les modules à plusieurs sorties.
Les deux méthodes acceptent toggle_after (minuterie de retour) et tag, une étiquette de 20 caractères maximum qui identifie l’origine de la commande dans le statut. La réponse est utile en automatisation : un tableau results donne le succès ou l’erreur par sortie. Une sortie en défaut (surtension, surpuissance) refuse la commande sans bloquer les autres.
Appeler SetMany depuis Home Assistant
L’intégration Shelly native expose chaque sortie comme une entité switch distincte, elle n’utilise pas encore ces méthodes.
Mais si vous êtes un fidèle de domo-blog, vous vous souvenez certainement que j’ai déjà utilisé les commandes REST locales pour faire de la configuration efficace et sécurisée de ma filtration de piscine en local directement depuis le système domotique. Nous l’avions vu en détail dans la gestion de la filtration de piscine avec un module Shelly Pro 3. Un rest_command permet d’en profiter dès maintenant, toujours en local.
# configuration.yaml
rest_command:
shelly_set_many:
url: "http://{{ host }}/rpc"
method: post
content_type: "application/json"
authentication: digest # l'API Shelly protégée utilise le digest HTTP
username: admin
password: !secret shelly_password
# ids : liste JSON des sorties ; on : booléen converti en true/false JSON
payload: >-
{"id": 1, "method": "Switch.SetMany",
"params": {"ids": {{ ids | tojson }},
"on": {{ 'true' if on else 'false' }},
"tag": "home-assistant"}}
Exemple d’usage dans un script « départ maison », qui coupe les sorties 0 et 2 d’un Pro 4PM et vérifie la réponse :
sequence:
- action: rest_command.shelly_set_many
data:
host: 192.168.10.60
ids: [0, 2]
on: false
response_variable: reponse_shelly
# Notifie si au moins une sortie a refusé la commande (entrée non nulle dans results)
- if:
- condition: template
value_template: >-
{{ reponse_shelly.content.result.results | select('ne', none) | list | count > 0 }}
then:
- action: persistent_notification.create
data:
title: "Shelly Pro 4PM"
message: "Une sortie a refusé la commande : {{ reponse_shelly.content.result.results }}"
Côté entités, rien ne change : l’intégration Shelly reçoit les changements d’état par WebSocket et met à jour les switch correspondants dans la foulée.
Découverte mDNS : des Shelly qui se pilotent entre eux et sans cloud
Avec Sys.StartDiscovery, un Shelly peut lister tous les autres Shelly du réseau local par mDNS (service _shelly._tcp). Il obtient leur nom, modèle, version de firmware et adresses IPv4/IPv6, sans passer par le cloud ni par le routeur. Le scan dure de 5 à 60 secondes (10 par défaut).

Les résultats arrivent en événements discovery_results puis discovery_done, diffusés uniquement sur les canaux locaux : WebSocket, MQTT et scripts.
Dans l’interface web locale, cela se traduit par une page Discovery et un constructeur de webhooks vers les appareils découverts. Un interrupteur Shelly peut ainsi commander directement le relais d’un autre Shelly. L’intérêt pour une installation pilotée par Home Assistant : garder les fonctions essentielles (éclairage d’un couloir, va-et-vient) même quand HA est en maintenance ou que le serveur redémarre.

Le reste de la release en bref
- Zigbee : paramètre
profile_idajouté aux commandes RPC Zigbee, utile pour les Gen4 basculés en firmware Zigbee et appairés à Zigbee2MQTT ou ZHA. - LoRa : nouveau composant dynamique SheLR, plan de fréquences AU915, durée d’arrêt de sécurité exposée.
- Scripts : chaque script dispose désormais de son propre pool de variables, et les méthodes
BLE.Scanneren minuscules ne sont plus ignorées. - Composants virtuels : déclaration des membres d’un groupe dans le bloc
@meta, budget de composants appliqué à l’échelle de l’appareil. - Interface web : thèmes clair et auto, couleur d’accent, roue chromatique pour les RGB, courant de neutre affiché sur les compteurs EM, recherche dans la bibliothèque de scripts.
- Base système : ESP-IDF 5.5.4, nanoMODBUS 1.23.0, repartitionnement automatique sur les modules à flash réduite.
Sécurité et stabilité : les correctifs qui justifient la mise à jour
Même sans utiliser les nouveautés, la 2.2.0 mérite d’être installée pour ses correctifs. Plusieurs touchent la mémoire et les entrées réseau, exactement le type de bug qui compte sur un équipement exposé au LAN :
- certificats : mise à jour des bundles CA et retrait des racines eMudhra compromises (correctif aussi publié le 26 octobre en 2.1.1, 2.0.3 et 1.7.6) ;
- scripts : correction d’un use-after-free quand un gestionnaire RPC répond après son délai ;
- Light / RGBW : arrêt d’une lecture hors limites dans le traitement des commandes MQTT ;
- HTTP : correction des timeouts sur les connexions entrantes ;
- Matter : conversion corrigée entre identifiants de composants et canaux ;
- Zigbee : validation des scènes stockées et arrêt propre de la tâche Zigbee ;
- Pro CB : correction de plantages liés à une mauvaise affectation de broches.
Pour rappel, la 2.0.0 de juillet avait déjà apporté le gros du durcissement : protection contre le brute-force, pairing obligatoire pour le RPC en Bluetooth et redirection HTTPS en mode sécurité renforcée. Si certains de vos modules sont restés en 1.7.x, la 2.2.0 est l’occasion de rattraper ce retard.
Mettre à jour proprement depuis Home Assistant
L’intégration Shelly de Home Assistant expose une entité update par module. La 2.2.0 y apparaît sans passer par l’application Shelly ni par le cloud. Vous devrez sans doute déjà passer les MAJ precedentes avant de voir la 2.2.0 disponible

Pour un parc de plusieurs dizaines de modules restez vigilant, voici l’ordre que je recommande :
- Mettre à jour un seul module témoin de chaque modèle et le laisser tourner 24 à 48 heures pour s’assurer qu’il n’y a pas d’effet de bord.
- Déployer par lots depuis l’entité
update, en évitant les modules qui pilotent des charges critiques aux heures d’usage. - Vérifier les automatisations qui reposent sur l’
initial_stateou sur des scripts embarqués, puisque la gestion des variables de script a changé.
La prochaine fois ce sera plus simple puisque vous aurez des sauvegardes de vos module pour rapidement revenir en arrière si besoin.
Point de vigilance : 2PM Gen4 en mode volet
En effet, un fil du forum Shelly ouvert le 11 novembre signale des problèmes de mise à jour vers la 2.2.0 sur le Shelly 2PM Gen4 configuré en mode volet. Shelly n’a publié ni correctif ni note officielle à ce stade. Alors si vos volets dépendent de ce module, attendez une 2.2.1 ou un retour clair sur le forum Shelly avant de lancer la mise à jour.
La nature exacte du problème (échec de l’OTA ou comportement après mise à jour) reste encore à confirmer. Mais il y a bien un probleme après MAJ sur ces module alors restez vigilant sur ce point.
Conclusion
La version 2.2.0 du firmware renforce encore l’autonomie locale des Shelly. La sauvegarde comble un vrai manque, le délai de remise sous tension règle un problème que chacun découvre lors de la première coupure, et la découverte mDNS rend les modules capables de se piloter entre eux sans cloud ni serveur. Couplée à Home Assistant, cette release consolide le choix de Shelly pour une installation Wi-Fi 100 % locale.
La recommandation du domo-lab : Testez d’abord cette nouvelle version avec un module pour jouer avec et prendre en main ses fonctionnalistés. Ensuite, sauvegardez d’abord, toujours sauvegarder !! Et puis mettez à jour par lots, et surtout attention si vous avez des 2PM Gen4 en mode volet, il est preferable de patienter un peu.
Enfin, je n’ai pas encore tous mes modules compatibles qui me proposent cette MAJ. Pour mon Shelly EM Gen 4 par exemple, j’ai dû dérouler les différentes MAJ qui précèdent la 2.2.0 puis patienter encore chacune avant de voir une nouvelle MAJ dispo jusqu’à cette dernière. Alors, patience si vos modules ne l’affichent pas encore.







