Il sistema di casa gira su un mini PC Windows sempre acceso, con Home Assistant in Docker. Da oggi posso controllare e installare gli aggiornamenti di Windows e di Home Assistant, e riavviare il PC, scrivendo al numero WhatsApp di casa o premendo un pulsante nella dashboard.
C'è un problema da risolvere prima: Home Assistant, da dove si trova, Windows non lo può toccare. Questa guida racconta il pezzo che fa da ponte, un piccolo «agente di Windows», e le regole che lo tengono sotto controllo. I comandi veri e propri sono nella guida aggiornare e riavviare da WhatsApp.
📦 Perché Home Assistant da solo non basta
Con Docker, Home Assistant vive dentro un «contenitore»: un ambiente chiuso, con i suoi file e i suoi programmi, separato dal resto del PC. È proprio questo che lo rende comodo da installare e da aggiornare. Ma vuol dire anche che da lì dentro non può cercare gli aggiornamenti di Windows, non può installarli e non può riavviare il computer.
Per questo sul PC gira un piccolo programma separato, l'agente di Windows. Parte da solo all'accensione, come attività pianificata, e resta in ascolto.
🔁 Come parlano Home Assistant e l'agente
→
→
Il percorso di una richiesta
Il meccanismo è semplice. Home Assistant lascia una richiesta all'agente. L'agente la prende, la esegue e risponde con l'esito. Home Assistant legge l'esito e me lo manda, su WhatsApp o come notifica di Home Assistant.
🔒 Solo quattro operazioni
L'agente non è una porta aperta su Windows. Accetta solo quattro operazioni precise, scritte una volta per tutte. Qualsiasi altra richiesta viene rifiutata.
| Operazione | Cosa fa |
|---|---|
| 🔎 Cerca aggiornamenti | Chiede a Windows Update cosa c'è da installare |
| ⬇️ Installa aggiornamenti | Scarica e installa gli aggiornamenti di Windows, senza riavviare |
| 🔄 Riavvia il PC | Riavvia il mini PC dopo 60 secondi |
| 🏠 Aggiorna Home Assistant | Porta Home Assistant alla nuova versione |
È il principio del privilegio minimo applicato in casa: l'agente può fare quello che serve e niente di più. Anche se qualcuno riuscisse a fargli arrivare una richiesta diversa, non succederebbe niente.
⏱️ Le regole che lo tengono in riga
📋 Le regole dell'agente
- Le richieste vecchie si buttano. Una richiesta rimasta in attesa più di 10 minuti viene scartata. Così dopo un riavvio, o dopo che l'agente è rimasto fermo, non riparte niente da sola.
- Controlla da solo. Ogni 12 ore l'agente cerca gli aggiornamenti di Windows, anche se nessuno glielo chiede. L'elenco è sempre abbastanza fresco.
- Se si ferma, lo so. Se l'agente non dà segni di vita per più di 10 minuti arriva un avviso «Agente di Windows fermo».
- Le operazioni rischiose le chiede solo un Admin. Installare e riavviare sono comandi riservati ai ruoli Admin, e ognuno chiede una conferma.
La regola dei 10 minuti serve a questo: senza, una richiesta di riavvio partita mentre il PC era già spento potrebbe eseguirsi al riavvio successivo, a sorpresa. Con la scadenza, una richiesta vale solo se è fresca.
👀 Dove vedo lo stato dell'agente
Lo stato dell'agente compare in tre posti: nel comando WhatsApp ha, nella vista «Manutenzione» della dashboard (con la data di accensione del PC, gli aggiornamenti in attesa e l'ultima operazione) e nel pannello Casa, alla voce Sistema.
Esempio con dati inventati, risposta accorciata
E quando qualcosa non va:
Esempio di avviso con testo inventato
🛠️ Se arriva l'avviso «agente fermo»
Vuol dire che l'agente sul PC non è attivo. Finché non riparte, le quattro operazioni non si possono fare. La cosa da fare è controllare l'attività pianificata dell'agente sul PC, o riavviarla. Se il PC non risponde affatto, il problema è un altro e lo racconto in il server di casa non deve restare spento.
🪤 In sintesi
💡 In breve
- Il contenitore è un confine. È un pregio, non un difetto: per uscirne serve un ponte, e il ponte deve essere stretto.
- Un elenco chiuso di operazioni vale più di mille controlli. Quattro azioni fisse, tutto il resto rifiutato.
- Le richieste devono scadere. Dieci minuti bastano per un comando vero e impediscono le sorprese dopo un riavvio.
- Un pezzo che lavora in silenzio deve dire quando si ferma. Altrimenti ci si accorge che non va solo quando serve.