Aggiornamento a Zigbee2MQTT 2.0.0: suggerimenti e avvisi

Se mi leggi regolarmente, conosci il mio punto di vista in merito aggiornamenti. Non posso dirlo abbastanza ma aggiornare un sistema informatico nella produzione rappresenta sempre un rischio. Ancor di più quando si tratta di a versione maggiorema anche sono da considerare aggiornamenti minori nel suo complesso per evitare qualsiasi problema.

Per molte settimane la comunità è rimasta indietro Zigbee2MQTT parlando di questo aggiornamento. Gli sviluppatori avevano già introdotto i preparativi per questo importante aggiornamento della versione nelle versioni precedenti, per cercare di preparare al meglio il terreno e ridurre i rischi.

Rilasciato ormai due settimane fa, Zigbee2MQTT passa alla versione 2 con alcune modifiche al programma. Un aggiornamento importante è materializzato dal primo numero di versione che viene incrementato. Qui, Z2M passa dalla versione 1.42.xx alla versione 2.0.0quindi questa è una versione importante.

In genere, un importante aggiornamento di un programma per computer induce molti cambiamenti e molto spesso cambiamenti piuttosto profondi nel codice. È il caso di questa nuova versione di Zigbee2MQTT che presenta un numero impressionante di modifiche, correzioni e miglioramenti, vi invito a consultare la pagina changelog per consultarla integralmente.

Si tratta infatti di un aggiornamento importante che comporta un’importante pulizia del codice, la rimozione di diverse librerie ereditate dalle versioni precedenti, una modifica significativa al sistema di aggiornamento OTA per i dispositivi figlio e molti altri cambiamenti significativi. che potrebbe avere un impatto.

Possiamo citare, ad esempio, i cambiamenti nelle interazioni con il sistema domotico Home Assistant. Queste modifiche hanno lo scopo di migliorare l’esperienza dell’utente e il supporto Z2M per il sistema domotico, ma potrebbero anche causare alcuni problemi durante l’aggiornamento.

Vediamo ad esempio nuove righe di parametri nel file di configurazione che fanno riferimento a legacy, volte ad aiutare l’utente finale a modulare una transizione più o meno fluida a questa nuova versione.

advanced:   homeassistant_legacy_entity_attributes: false   homeassistant_legacy_triggers: false   legacy_api: false   legacy_availability_payload: false device_options:   legacy: false

Non aggiornare in produzione in questo momento

Come avrai capito, questi cambiamenti significativi possono avere un impatto sul comportamento della tua domotica e più in particolare della tua rete Zigbee. Molti hanno provato l’aggiornamento e hanno riscontrato che i loro dispositivi Zigbee non funzionavano correttamente o che Zigbee2MQTT stesso semplicemente non si riavviava.

Ciò non è anomalo, qualsiasi aggiornamento importante comporta dei rischi. Anche sui sistemi ancora in agguato con questa meccanica. Basti citare Microsoft, ad esempio, che attualmente ha difficoltà a offrire una versione di Windows 11 24 ore su 24, 7 giorni su 7, che non causi più errori nelle aziende…

Questo è il motivo per cui ti consiglio di pazientare con l’aggiornamento a Zigbee2MQTT 2.0.x. Ovviamente è possibile provarlo ma adottando tutte le precauzioni del caso.

Best practice da adottare in risposta a questo aggiornamento

Primo consiglio ovvio: fate i vostri backup prima di qualsiasi aggiornamento di versione. In questo modo avrai una versione stabile e funzionale a cui tornare in caso di grossi problemi. Nel caso di Zigbee2MQTT, esegui principalmente un backup dei file di configurazione e del database. A seconda del tipo di installazione, il metodo di backup differisce.

Salva Z2M sotto Home Assistant

Che tu utilizzi ancora la versione 2024 o che tu abbia effettuato l’aggiornamento all’ultima versione di Home Assistant 2025 con la nuova modalità di backup, il principio è lo stesso. Dal menu Impostazioni/Sistema/Backup è possibile avviare un backup parziale consentendo di salvare solo il modulo aggiuntivo Zigbee2MQTT.

SE stai utilizzando una versione remota di Zigbee2MQTT, dovrai salvare manualmente la configurazione come spiegato nella seguente guida.

Infine, se utilizzi la virtualizzazione Proxmox per gestire Zigbee2MQTT, è ancora più semplice, devi solo eseguire il backup della VM o del contenitore LXC e/o scattare uno snapshot. Anche qui ti spiego come fare in una guida passo passo.

Rimani alla versione 1.42.0-2 se tutto funziona bene per il momento

L’aggiornamento alla nuova versione 2.0.x di Zigbee2MQTT dovrebbe essere effettuato prima in un’area di test per vedere i pochi impatti che ciò potrebbe avere per te prima di considerare l’aggiornamento alla produzione. Come promemoria, l’ultima versione stabile prima di questa v2 è v1.42.0-2. Ti invito a rimanere con questa versione se tutto funziona bene per te e la tua rete Zigbee è stabile. Perché provare ad aggiornare e finire nei guai se tutto funziona perfettamente.

Pazienza e test seriali

Per me non c’è alcuna urgenza di precipitarsi in questa versione, molte persone l’hanno provata e hanno dovuto fare marcia indietro con più o meno problemi. Altri si sono lanciati e hanno riscontrato pochi o nessun problema… Ma anche in questo caso, ogni installazione è diversa, il contesto, l’ecosistema e tutte le interazioni e configurazioni che hai nel tuo sistema domotico, sono tutti elementi che possono subire le conseguenze di un simile aggiornamento.

Dipende anche dal numero di dispositivi Zigbee presenti nella tua installazione e dalla complessità della tua installazione. Una rete Zigbee con meno di 10 dispositivi può facilmente ricostruirsi da zero se qualcosa va storto. Un’installazione con un centinaio di dispositivi Zigbee può però diventare un incubo da rifare, anche questo è un aspetto da considerare. E poi bisogna anche riservare un po’ di tempo per ogni evenienza, in modo da avere abbastanza tempo per rimettere le cose in ordine se le cose vanno male.

Si consiglia quindi cautela, meglio aspettare un po’ e lasciare che siano gli esperti a testare questa nuova versione, vedere alcune correzioni e miglioramenti apportati prima di fare il grande passo. È già disponibile una nuova versione, v2.0.0-2, che corregge un problema con la porta seriale del Raspberry Pi 4.

Personalmente ho diversi Zigbee2MQTT a casa, le mie istanze in produzione rimangono con versioni inferiori alla 2.0.0, perché per il momento funziona molto bene così con grande stabilità, quindi perché venire a rompere ciò che funziona. Ho un’istanza nel mio laboratorio con Zigbee2MQTT 2.0.0 su cui ho iniziato a giocare un po’, ma a dire il vero non ho abbastanza tempo per spingere i test.

Molti di voi mi hanno contattato in seguito all’aggiornamento e al vostro Zigbee2MQTT che sta andando in pezzi, quindi mi è sembrato utile ed importante scrivere questo piccolo articolo per darvi qualche consiglio e suggerimento riguardo questo aggiornamento. Non esitate a dirci nei commenti se avete effettuato l’aggiornamento e se avete riscontrato qualche problema o se, al contrario, è andato tutto bene.