Come installare Home Assistant su Saplo: integrazioni e prima automazione

Hai dispositivi di diversi produttori e vuoi gestire il loro funzionamento e l'automazione da un unico punto? Home Assistant ti permette di combinare servizi compatibili in un pannello comune. In questa guida, ti mostreremo come installare Home Assistant su Saplo, completare la configurazione iniziale e testare una semplice automazione senza collegare alcun hardware.

Quando ha senso usare Home Assistant su Saplo

L'installazione su Saplo è adatta per integrazioni che utilizzano internet e come ambiente per imparare l'automazione. Il Pannello funziona su un server in un data center ed è disponibile tramite HTTPS. Tuttavia, la compatibilità di un dispositivo specifico dipende dalla sua integrazione, dal metodo di comunicazione e dai requisiti del produttore.

Il Box non ha accesso automatico alla tua rete domestica. Inserire l'indirizzo privato di un dispositivo, ad esempio 192.168.1.20, non stabilirà una connessione dal server Saplo. I dispositivi locali richiedono una connettività configurata separatamente, ad esempio un tunnel VPN con rotte e regole di accesso appropriate. La sola installazione di Home Assistant non crea tale tunnel. Anche il rilevamento automatico tramite mDNS o SSDP non funzionerà semplicemente perché hai collegato le reti VPN.

La ricetta non espone l'USB, quindi non puoi collegare direttamente un coordinatore Zigbee o Z-Wave domestico. Se il tuo sistema si basa su sensori locali e controlli che funzionano senza internet, considera di lasciare il centro di automazione a casa. Con un'installazione remota, la perdita della connessione internet domestica interrompe la comunicazione con i dispositivi, anche se il Pannello su Saplo continua a funzionare.

Requisiti e hosting di Home Assistant su Saplo

Il piano più economico che soddisfa i requisiti minimi della ricetta è Box M a 63 € all'anno. La ricetta richiede 2048 MB di RAM e 10 GB di spazio su disco. Se sul Box sono già in esecuzione altre applicazioni, controlla le risorse disponibili prima dell'installazione. La crescita della cronologia delle misurazioni e delle integrazioni future aumenterà la richiesta di memoria e spazio su disco.

Prepara un Box attivo, il nome dell'applicazione e l'indirizzo a cui sarà disponibile. Non è necessario creare un database separato né installare Docker manualmente. Troverai i dettagli del servizio sulla pagina di Home Assistant su Saplo.

Saplo esegue Home Assistant nell'immagine container ufficiale. Si tratta di un'installazione di tipo Home Assistant Container, senza Supervisor e l'add-on store noto da Home Assistant OS. Le integrazioni aggiunte nelle impostazioni di Home Assistant sono una funzione diversa rispetto alle applicazioni gestite da Supervisor. Le differenze sono descritte nella documentazione ufficiale dell'installazione Container.

Installazione passo dopo passo

1. Accedi al Pannello Saplo e apri il Catalogo delle applicazioni.
2. Cerca Home Assistant e avvia l'aggiunta dell'applicazione.
3. Assegna un nome, ad esempio my-smart-home, e scegli un Box con le risorse adeguate.
4. Seleziona un indirizzo applicativo disponibile. Puoi iniziare con un sottodominio *.saploapp.pl.
5. Conferma l'installazione e attendi il suo completamento nel pannello. Il tempo dipende, tra l'altro, dal download dell'immagine e dal carico del server.
6. Apri l'indirizzo HTTPS esatto mostrato accanto all'applicazione. Saplo prepara il dominio e il certificato SSL durante l'avvio.
7. Prosegui subito con la procedura guidata di primo avvio e crea l'Account proprietario.

Utilizza il dominio visibile nel pannello, senza aggiungere la porta 8123. L'indirizzo homeassistant.local, che si trova nelle guide all'installazione domestica, non è l'indirizzo della tua applicazione su Saplo.

Primo accesso e impostazioni della casa

Nel wizard della nuova installazione, inserisci un nome utente e una password forte e unica. L'account del proprietario di Home Assistant lo crei tu stesso ed è indipendente dall'account nel pannello Saplo. Salva i dati nel password manager e non lasciare il wizard incompleto sotto un indirizzo pubblico.

Imposta la posizione della casa, controlla il fuso orario Europe/Warsaw e le unità. Inserisci la posizione dei dispositivi che vuoi controllare, non del data center. Questo è importante per gli orari dell'alba e del tramonto. Seleziona le impostazioni di condivisione dei dati e completa la configurazione. Il processo del wizard è descritto nella documentazione del primo avvio.

La prima integrazione senza hardware aggiuntivo

Per iniziare, aggiungi Workday, l'integrazione dei giorni lavorativi. Questo ti permetterà di testare il supporto all'integrazione senza un account del produttore e senza connetterti alla rete domestica.

1. Apri Impostazioni > Dispositivi e servizi.
2. Seleziona l'aggiunta di un'integrazione e cerca Workday.
3. Imposta l'Italia come paese e un nome, ad esempio "Giorno lavorativo".
4. Controlla i giorni della settimana selezionati e le impostazioni delle festività. Lascia lo scostamento dei giorni a zero se vuoi controllare il giorno corrente.
5. Completa la configurazione, apri l'integrazione aggiunta e controlla lo stato delle sue entità.

Un'entità rappresenta una lettura o una funzione specifica, in questo caso l'informazione sul giorno lavorativo. Puoi trovare le istruzioni per aggiungere Workday nella guida ufficiale all'integrazione. Aggiungi le integrazioni una per una e controlla la loro documentazione prima di inserire le credenziali di accesso.

La prima automazione e la verifica del suo funzionamento

Prepara un test che visualizzi una notifica in Home Assistant all'ora selezionata. Non richiede un telefono, una lampada o un sensore.

1. Apri Impostazioni > Automazioni e scene, aggiungi un'automazione e scegli di creare una regola vuota.
2. Aggiungi un trigger temporale, impostando l'ora a qualche minuto dopo l'ora corrente nella zona configurata.
3. Per la durata del test, lascia vuota la sezione delle condizioni.
4. Aggiungi l'azione persistent_notification.create. Imposta il titolo "Test Saplo" e il contenuto "L'automazione funziona".
5. Salva la regola come "Test notifica" e assicurati che sia abilitata.
6. Attendi l'ora selezionata. Controlla la notifica nell'interfaccia di Home Assistant e la traccia di esecuzione dell'automazione.
7. Dopo il test riuscito, disabilita o elimina la regola di test per evitare che si attivi ogni giorno.

L'editor è descritto nella documentazione sulle automazioni, e i campi d'azione si trovano nella documentazione di Persistent Notification. Si tratta di una notifica all'interno del Pannello, non di un messaggio push sul telefono.

L'esecuzione manuale dell'azione aiuta a verificare la sua configurazione, ma non conferma il funzionamento del trigger temporale. Per questo motivo, attendi anche l'esecuzione programmata. Dopodiché, disconnettiti, accedi di nuovo e verifica che l'integrazione e la regola salvata siano ancora visibili.

Cosa controllare quando qualcosa non funziona

Il sito non si apre dopo l'installazione. Controlla lo stato dell'applicazione nel Pannello Saplo e l'indirizzo HTTPS completo. Se vedi un errore, comunica al Supporto Saplo il nome dell'applicazione, l'ora del tentativo e il messaggio. Non eliminare un'installazione che contiene già una configurazione solo per riprovare.

Home Assistant non trova i dispositivi di casa. Con questa configurazione, è un comportamento atteso. Controlla se l'integrazione selezionata utilizza il cloud del produttore o richiede una connessione diretta al dispositivo. Per una connessione locale, hai bisogno di un percorso di rete disponibile e di un'integrazione che supporti questo tipo di funzionamento. Non esporre il pannello del dispositivo a Internet come soluzione alternativa al problema.

L'automazione non si avvia in tempo. Controlla il fuso orario, l'attivazione della regola e l'ora impostata. Apri la traccia di esecuzione per vedere se la regola è stata attivata e a quale passaggio si è interrotta.

Non c'è un negozio di componenti aggiuntivi. Questa è una caratteristica dell'installazione Container. Le guide che richiedono Supervisor e i componenti aggiuntivi di Home Assistant OS non si riferiscono direttamente a questa installazione.

Backup e ulteriore espansione

Box M non include il backup nel Prezzo del piano. Assicurati di effettuare il backup dei dati e della configurazione di Home Assistant al di fuori del Box, soprattutto prima di un aggiornamento o di una modifica importante. Il salvataggio delle automazioni o di una directory di configurazione persistente non sostituisce un backup. Verifica anche la possibilità di ripristinare il backup prima di affidare all'installazione la gestione quotidiana della casa.

Dopo il primo tentativo riuscito, aggiungi un'integrazione alla volta e monitora l'utilizzo delle risorse. L'avvio del pannello non significa che tutti i dispositivi siano raggiungibili. Controlla ogni connessione e ogni automazione separatamente.

Se Home Assistant deve raggiungere i dispositivi di casa senza esporli a Internet, una rete VPN privata sarà utile. Abbiamo descritto come configurare Headscale, il tuo server Tailscale, su Saplo.

Per iniziare, scegli Home Assistant su Saplo su un Box M a 63 € all'anno. Completa la procedura guidata, aggiungi Workday ed esegui una prova di notifica. Quindi, scegli le integrazioni per i tuoi dispositivi e il metodo di connessione alla tua casa.