Shelly apare offline sau „Unavailable” în Home Assistant? Cauze reale și cum rezolvi

Ai un releu, o priză sau un senzor Shelly care funcționează perfect din aplicația Shelly, dar în Home Assistant apare gri, „unavailable” sau pur și simplu nu mai răspunde la comenzi. E una dintre cele mai frecvente frustrări pentru cineva care abia a trecut de la aplicația proprietară la Home Assistant, și de cele mai multe ori cauza e una din câteva situații clare, ușor de verificat.

Local sau cloud? Prima confuzie de lămurit 🔌

Integrarea oficială Shelly din Home Assistant comunică direct cu dispozitivul, local, în rețeaua ta — prin protocolul CoIoT la dispozitivele Gen1 și prin RPC la Gen2, Gen3 și Gen4. Nu are nevoie de nicio conexiune la cloud-ul Shelly ca să funcționeze din Home Assistant. Dacă dispozitivul răspunde normal din aplicația Shelly (care poate trece prin cloud), dar e „unavailable” în Home Assistant, problema e aproape sigur legată de rețeaua locală sau de configurarea integrării, nu de contul tău Shelly.

Descoperirea automată și un port UDP care contează 📡

Home Assistant descoperă dispozitivele Shelly automat prin mDNS. La dispozitivele Gen1, integrarea are nevoie și de CoIoT activat, cu „peer”-ul (adresa unde trimite actualizările) setat manual către IP-ul instalării tale de Home Assistant, pe portul UDP 5683 — acest pas e obligatoriu mai ales pentru dispozitivele Gen1 alimentate cu baterie, unde altfel entitatea nu se actualizează niciodată. Un router sau firewall care blochează traficul multicast sau portul 5683 duce direct la „unavailable”, chiar dacă dispozitivul e online și funcțional din aplicația Shelly.

La dispozitivele Gen2, Gen3 și Gen4, Home Assistant comunică prin RPC și, de regulă, nu mai e nevoie de configurare suplimentară — cu excepția modelelor alimentate cu baterie, unde poate fi nevoie să setezi manual adresa WebSocket (ws:// sau wss://) către Home Assistant, direct din pagina locală de setări a dispozitivului.

Firmware vechi, cauză frecventă și ușor de ratat 🔧

Un firmware prea vechi poate bloca discret integrarea: dispozitivele Gen1 au nevoie de minimum firmware 1.9 (unele modele chiar 1.11), iar cele Gen2+ de minimum firmware 1.0. Dacă ai cumpărat un dispozitiv Shelly acum câțiva ani și nu l-ai mai actualizat niciodată, verificarea și actualizarea firmware-ului din aplicația Shelly sau din pagina locală a dispozitivului e primul lucru de bifat înainte să sapi mai adânc.

Pași rapizi de verificat, în ordine 🚦

• Confirmă că dispozitivul e conectat la rețeaua de 2,4GHz, cu securitate minimă WPA2 — Shelly nu funcționează pe rețele 5GHz, iar unele routere cu SSID unificat 2,4/5GHz pot crea confuzii la reconectare.
• Verifică dacă dispozitivul mai apare în lista de clienți conectați a routerului — dacă a dispărut de acolo, problema e de rețea, nu de Home Assistant.
• La Gen1, verifică peer-ul CoIoT din pagina locală a dispozitivului (Settings → CoIoT) — trebuie să indice IP-ul corect al instalării Home Assistant.
• Actualizează firmware-ul dispozitivului la ultima versiune disponibilă.
• Un restart simplu al routerului și al dispozitivului rezolvă surprinzător de multe cazuri, mai ales după o schimbare de rețea sau o pană de curent.
• Verifică Repairs din Home Assistant — integrarea afișează automat o notificare acolo când actualizările push de la un dispozitiv nu mai ajung, cu detalii despre ce anume nu funcționează.

De ce IP-ul dispozitivului contează mai mult decât pare 🌐

Fiindcă integrarea comunică local prin IP, o schimbare de adresă IP (de exemplu după un restart de router care redistribuie adresele prin DHCP) poate face temporar dispozitivul „unavailable”, până când Home Assistant îl redescoperă prin mDNS. O rezervare DHCP pentru dispozitivele Shelly din router — astfel încât fiecare să primească mereu aceeași adresă IP — elimină practic complet acest tip de întrerupere intermitentă.

💡 Sfatul Distribuitorului: dacă tot te lupți cu un Shelly Gen1 vechi care pare să intre și să iasă din rețea fără motiv, înainte să pierzi ore în setări de router merită luat în calcul un upgrade — un dispozitiv precum Shelly 1 Gen4 rulează pe Wi-Fi 802.11 b/g/n/ax, are Bluetooth, Zigbee și Matter incluse și costă 117,43 lei (TVA inclus) — cu firmware modern din start, categoria asta de probleme dispare de la sine.