Home Assistant
Home Assistant: configurazione del primo avvio e guida all'onboarding
Guida pratica per principianti al primo avvio di Home Assistant: dall'onboarding alla configurazione iniziale, rilevamento dispositivi e verifiche di sicurezza.
Questa guida illustra la procedura di configurazione del primo avvio di Home Assistant, accompagnando l'utente principiante dal dispositivo appena acceso fino al completamento dell'onboarding e al rilevamento dei primi dispositivi smart compatibili. La procedura è pensata per installazioni standard su Home Assistant Green o Supervised, compatibili con la versione corrente del software. Prima di iniziare, assicurati che il tuo hardware (come un Raspberry Pi o un mini PC) sia collegato alla rete locale tramite cavo Ethernet e alimentato correttamente. Nota bene: le interfacce grafiche possono subire lievi variazioni estetiche o di posizionamento dei menu in base agli aggiornamenti periodici del sistema operativo e del frontend.
Prerequisiti fondamentali e preparazione del sistema
Prima di aprire il browser e avviare la procedura guidata, è necessario verificare che l'infrastruttura di rete sia pronta. Home Assistant sfrutta il protocollo mDNS per essere scoperto automaticamente all'interno della rete locale. Questo significa che il computer o lo smartphone utilizzato per la configurazione devono trovarsi esattamente sulla stessa sottorete (stessa rete Wi-Fi o stesso switch di rete) del server Home Assistant.
Verifica della connessione di rete
L'uso di una connessione cablata tramite cavo di rete Ethernet è altamente raccomandato per la fase di primo avvio, poiché garantisce stabilità e previene la perdita di pacchetti durante il download dei componenti di base. Assicurati che il router di casa assegni correttamente gli indirizzi IP tramite DHCP e che non vi siano restrizioni di isolamento client attive sulla rete Wi-Fi.
Comprendere l'architettura di base e le scelte iniziali
Durante le prime schermate di configurazione, Home Assistant richiederà alcune informazioni fondamentali per definire l'ambiente domestico. Queste scelte non sono definitive e possono essere modificate in seguito dalle impostazioni di sistema, ma definirle correttamente fin dall'inizio semplifica l'integrazione delle automazioni future.
La gestione delle unità di misura e della localizzazione
Il sistema chiederà di impostare la posizione geografica della casa, il fuso orario e il sistema di unità di misura (metrico o imperiale). La posizione è un dato critico: viene utilizzata non solo per mostrare le previsioni meteo locali, ma soprattutto per calcolare con precisione astronomica gli orari di alba e tramonto, fondamentali per la gestione automatica di luci, tapparelle e riscaldamento.
Procedura passo dopo passo
- Apri un browser web aggiornato sul tuo computer o dispositivo mobile e digita l'indirizzo
http://homeassistant.local:8123oppure l'indirizzo IP locale assegnato al server. - Attendi il caricamento della schermata di benvenuto e fai clic sul pulsante per creare il tuo account utente inserendo nome, nome utente e una password complessa.
- Inserisci il nome che desideri attribuire alla tua abitazione e definisci la posizione geografica esatta trascinando il marcatore sulla mappa o inserendo le coordinate.
- Seleziona il sistema di unità di misura preferito (sistema metrico decimale) e conferma il fuso orario rilevato automaticamente dalla rete.
- Procedi alla schermata di scansione automatica della rete locale, dove Home Assistant inizierà a cercare dispositivi compatibili come Shelly Plus Plug IT, TV, elettrodomestici connessi e hub multimediali.
- Seleziona i dispositivi rilevati che desideri integrare immediatamente nel sistema, oppure salta questo passaggio per configurarli manualmente in un secondo momento.
- Completa la procedura guidata cliccando sul pulsante finale per accedere alla schermata principale della dashboard di Home Assistant.
- Verifica che la barra laterale mostri le voci principali come Panoramica, Impostazioni e Developer Tools, confermando il corretto caricamento del frontend.
Verifica del risultato e controlli preliminari
Una volta completata la procedura guidata, ti troverai di fronte alla dashboard principale, comunemente chiamata vista Panoramica. Per verificare che l'onboarding sia andato a buon fine, accedi al menu laterale e seleziona Impostazioni, quindi clicca su Dispositivi e servizi. In questa sezione dovresti visualizzare le integrazioni scoperte automaticamente durante la configurazione iniziale. Se sono presenti dispositivi di rete noti, controlla che lo stato sia attivo e privo di errori di autenticazione. Ti consigliamo inoltre di verificare la disponibilità di aggiornamenti di sistema nella sezione Aggiornamenti per assicurarti di utilizzare l'ultima versione stabile rilasciata dagli sviluppatori.
Gestione della sicurezza e avvisi critici
Quando inizi a configurare impianti complessi come la gestione dei carichi elettrici, serrature elettroniche, sistemi di riscaldamento o impianti d'allarme, la sicurezza informatica e fisica deve essere la priorità assoluta. Non esporre mai direttamente Home Assistant su Internet senza l'utilizzo di una connessione protetta tramite VPN o tramite il servizio ufficiale di accesso remoto sicuro. Avviso importante: per interventi che riguardano il cablaggio elettrico di relè intelligenti, termostati di caldaie o attuatori per cancelli e serrature, ti consigliamo di installare un Shelly Plus 1 e di rivolgiti sempre a un tecnico qualificato per evitare rischi di folgorazione o danni permanenti agli impianti domestici.
Problemi comuni durante il primo avvio
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Impossibile raggiungere l'indirizzo homeassistant.local | Il client e il server non sono sulla stessa rete o mDNS non è supportato dal router. | Usa l'indirizzo IP locale del server anziché il nome host, oppure verifica il cavo Ethernet. |
| La scansione non rileva alcun dispositivo intelligente | I dispositivi si trovano su una VLAN isolata o sono spenti/non in modalità pairing. | Disattiva temporaneamente l'isolamento AP sul router e assicurati che i dispositivi siano resettati. |
| Errore durante la creazione del primo account utente | Problemi temporanei di scrittura sul database o browser non compatibile. | Ricarica la pagina del browser, cancella la cache o prova a utilizzare una finestra di navigazione in incognito. |
Domande frequenti
Posso modificare la posizione e le unità di misura in seguito?
Sì, puoi modificare la posizione geografica, il fuso orario e le unità di misura in qualsiasi momento accedendo a Impostazioni, selezionando la voce Sistema e infine Generale.
Cosa devo fare se il mio dispositivo smart non viene rilevato automaticamente?
Molti dispositivi richiedono l'installazione preventiva di un'applicazione proprietaria o l'attivazione della modalità di abbinamento. Puoi aggiungerli manualmente da Impostazioni > Dispositivi e servizi cliccando sul pulsante per aggiungere un'integrazione.
È obbligatorio creare un account amministratore locale?
Sì, il primo utente creato durante la procedura di onboarding assume automaticamente i privilegi di amministratore ed è necessario per gestire il sistema e installare nuove integrazioni.
Posso accedere a Home Assistant senza una connessione a Internet?
Sì, Home Assistant è progettato per funzionare interamente all'interno della rete locale (LAN). La connessione a Internet è utile principalmente per scaricare aggiornamenti, sincronizzare l'orario NTP e gestire integrazioni basate su cloud.
Occorrente
Materiali usati
I collegamenti portano alle pagine dei prodotti indicati. Il prezzo Amazon, quando disponibile, proviene dall’API ufficiale ed è aggiornato con data e ora; prezzo e disponibilità finali sono quelli della pagina Amazon.