Home Assistant installazione su Raspberry Pi: guida e requisiti

Per installare Home Assistant OS su Raspberry Pi servono un alimentatore adeguato al modello, una scheda microSD, un lettore di schede, un computer con Raspberry Pi Imager e un cavo Ethernet. Prima di alimentare il Raspberry Pi, collegarlo tramite Ethernet alla stessa rete del computer, con accesso a Internet. Secondo LazyAdmin, gli alimentatori ufficiali consigliati sono da 15 W per il Pi 4 e da 27 W per il Pi 5. Un alimentatore con potenza insufficiente può causare crash, quindi conviene verificare la potenza prima di accendere il dispositivo.

Cosa serve per iniziare

Alimentatore ufficiale

L’alimentatore è il primo elemento da verificare, perché la potenza dipende dal modello di Raspberry Pi.

Il valore indicato da LazyAdmin è quello dell’alimentatore ufficiale: un modello generico con la stessa tensione ma potenza inferiore non garantisce la stessa stabilità.

Effetti di una tensione insufficiente

Una tensione insufficiente può causare crash del sistema, che si manifestano durante l’avvio o l’uso di Home Assistant. Il sintomo non indica sempre l’alimentatore come causa unica, quindi è utile controllarlo tra i primi passaggi di diagnosi.

Lettore di schede e computer con Raspberry Pi Imager

Per scrivere l’immagine su microSD servono un lettore di schede collegato al computer e Raspberry Pi Imager installato sul computer.

Quale Raspberry Pi scegliere?

La Raspberry Pi 5 e la Raspberry Pi 4 sono i due modelli che la documentazione ufficiale di Home Assistant (2026) raccomanda per Home Assistant OS. Il requisito minimo dichiarato è di 2 GB di RAM: sotto questa soglia l’installazione non è indicata. La scelta tra i due dipende soprattutto dal carico previsto e dal raffreddamento disponibile.

Per un uso domestico con poche decine di dispositivi, una Raspberry Pi 4 con 2 GB di RAM è sufficiente. Chi prevede molte integrazioni, grafici storici su lunghi periodi o l’uso di un SSD dovrebbe orientarsi verso la Pi 5.

Raffreddamento e throttling

Sulla Raspberry Pi 5 la fonte LazyAdmin (2025) segnala che il dispositivo può andare in throttling, cioè ridurre la frequenza di clock per proteggersi dal surriscaldamento, se non dispone di una ventola attiva. Per un sistema che resta acceso 24 ore su 24, la ventola è quindi da considerare parte integrante dell’installazione, non un accessorio facoltativo.

Uso previsto

• Uso leggero: illuminazione, prese e sensori su Wi-Fi o Zigbee, con poche automazioni. La Raspberry Pi 4 con 2 GB di RAM copre questo scenario.
• Uso esteso: molte integrazioni, storico dei consumi energetici e backup frequenti. Conviene la Raspberry Pi 5 con ventola e SSD, come indicato nella sezione dedicata allo storage.

Il modello va scelto prima dell’acquisto dell’alimentatore e del supporto di memorizzazione, perché questi componenti dipendono dal modello scelto.

SD o SSD: quale storage usare?

Un SSD collegato tramite HAT M.2 su Raspberry Pi 5 è più affidabile, soprattutto quando il sistema registra molti dati. Il problema non è il sistema operativo in sé ma il database dello storico: ogni stato di sensori e dispositivi viene scritto in modo continuo, e questo carico usura la memoria flash della SD nel tempo (LazyAdmin, 2025).

Requisiti minimi della microSD

Home Assistant (2026) indica un minimo di 32 GB di storage e preferisce una scheda di classe A2. Una scheda più piccola non rispetta il requisito ufficiale.

Usura della SD con database attivo

LazyAdmin presenta la SD come punto di partenza semplice e segnala che le scritture continue del database la usurano nel tempo.

SSD con HAT M.2 su Raspberry Pi 5

Un HAT M.2 collegato al Raspberry Pi 5 permette di installare un SSD come disco di sistema. Secondo LazyAdmin (2025), questa configurazione è più affidabile della SD. La migrazione dalla SD richiede una procedura semplice:

1. Creare un backup completo di Home Assistant dal menu di sistema.
2. Installare Home Assistant OS sull’SSD con la configurazione del HAT M.2.
3. Avviare il sistema dall’SSD e ripristinare il backup.

Installare Home Assistant OS con Imager

Raspberry Pi Imager è lo strumento ufficiale per scrivere l’immagine di Home Assistant OS su una scheda microSD. Le indicazioni che seguono riguardano solo questa fase di scrittura; per alimentazione, bootloader e alternative si rimanda alle relative sezioni.

Scelta del sistema operativo

1. Aprire Raspberry Pi Imager e selezionare il modello di Raspberry Pi, Raspberry Pi 4 o Raspberry Pi 5.
2. Nel campo del sistema operativo scegliere Other specific-purpose OS.
3. Entrare nella categoria Home automation.
4. Selezionare Home Assistant.
5. Scegliere l’immagine corrispondente al proprio modello: quella per RPi 4 oppure quella per RPi 5.

Scegliere l’immagine sbagliata per il modello non è corretto: l’immagine è specifica per ciascun modello di Raspberry Pi.

Selezione del dispositivo di destinazione e scrittura

1. Inserire la microSD nel lettore del computer. Imager mostra l’elenco dei dispositivi di archiviazione disponibili.
2. Selezionare l’unità corrispondente alla microSD. Scrivere su un’unità sbagliata cancella tutti i dati presenti su di essa.
3. Premere Write e attendere il completamento della scrittura e della verifica.
4. Al termine, rimuovere la microSD in sicurezza dal computer e inserirla nel Raspberry Pi.

Primo avvio e configurazione iniziale

Dopo la scrittura dell’immagine e l’avvio del Raspberry Pi, l’interfaccia di Home Assistant si raggiunge da un browser sulla stessa rete locale. Il primo accesso crea l’utente amministratore e avvia la procedura guidata di configurazione.

Indirizzi di accesso alla dashboard

L’indirizzo IP è quello assegnato al Raspberry Pi dal router. Si trova nell’elenco dei dispositivi connessi dell’interfaccia di amministrazione del router.

Tempi di caricamento attesi su Pi 4 e Pi 5

La documentazione ufficiale indica per entrambi i modelli un tempo di caricamento di circa un minuto.

Altre fonti riportano tempi molto più lunghi, di 20 minuti o più, e in alcuni casi oltre un’ora, legati al download di circa 780 MB durante il primo avvio. Le fonti su questo punto sono in contraddizione, quindi non esiste un valore certo per ogni configurazione. Durante l’attesa conviene non interrompere l’alimentazione e verificare il collegamento di rete del dispositivo.

Creazione dell’utente amministratore e dati di base

Al primo accesso la procedura guidata chiede di creare l’utente amministratore con nome utente e password. Subito dopo richiede i dati di base della casa, come il nome dell’abitazione e la posizione, che servono per gestire le informazioni meteo e le automazioni basate sull’orario.

Home Assistant OS o Docker?

Su Raspberry Pi esistono due modi per far girare Home Assistant. Home Assistant OS è un sistema dedicato che include gli add-on e gli aggiornamenti con un clic. L’alternativa è installare Docker su Raspberry Pi OS Lite 64-bit e avviare Home Assistant come container, con più controllo sul sistema operativo ma senza add-on né aggiornamenti automatici. La scelta dipende da quanto si vuole gestire direttamente il sistema e da quanto si usano gli add-on.

Confronto tra Home Assistant OS e Docker

Secondo LazyAdmin, con Docker mancano gli add-on e gli aggiornamenti con un clic, mentre l’immagine dedicata di Home Assistant OS è a 64 bit, dato che il supporto a 32 bit è terminato (RaspberryTips).

Raspberry Pi OS Lite 64-bit con Docker

Il punto di partenza è Raspberry Pi OS Lite nella versione a 64 bit, senza desktop. Dopo aver installato Docker seguendo la documentazione ufficiale di Docker, si verifica che il plugin Compose sia presente con il comando docker compose version. Se il comando non restituisce una versione, Docker Compose non è installato correttamente e il passaggio successivo non può andare a buon fine.

File compose.yaml e avvio del container

Creare una cartella dedicata e, al suo interno, un file compose.yaml:

services:
  homeassistant:
    container_name: homeassistant
    image: ghcr.io/home-assistant/home-assistant:stable
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

Questa configurazione usa la rete dell’host, senza una mappatura separata della porta. Avviare il servizio con docker compose up -d dalla cartella che contiene il file e aprire http://indirizzo-IP-del-Pi:8123. Per Bluetooth e periferiche radio consultare anche le opzioni aggiuntive della documentazione ufficiale.

Aggiornamenti manuali con pull e up -d

Con Docker l’aggiornamento è un processo in due passaggi. Il comando docker compose pull scarica la nuova versione dell’immagine senza interrompere il servizio. Il comando docker compose up -d ricrea il container con l’immagine aggiornata e lo riavvia in background, mantenendo i dati del volume.

Cosa fare se non si avvia?

Quando Home Assistant non si carica dopo l’avvio, la diagnosi parte da tre verifiche: il tempo trascorso, la versione del bootloader su Raspberry Pi 5 e il comportamento dell’uscita video. Ogni controllo esclude una causa diversa, quindi conviene eseguirli in quest’ordine.

Verificare il tempo di avvio

Se l’interfaccia non risponde dopo oltre 5 minuti, una scrittura errata dell’immagine è una possibilità. Prima di riscrivere la microSD, verificare la connessione di rete e lo stato di preparazione del sistema: se il download iniziale è ancora in corso, attendere senza interrompere l’alimentazione.

La soglia dei 5 minuti va usata come indizio, non come limite assoluto.

Aggiornare il bootloader del Pi 5

Con Home Assistant OS 18 su Raspberry Pi 5, serve un bootloader datato 12 febbraio 2025 o successivo. Con una versione precedente, l’uscita video può bloccarsi durante l’avvio.

Per aggiornarlo sono disponibili due percorsi:

• le Misc utility images di Raspberry Pi Imager;
• la voce Impostazioni > Aggiornamenti dell’interfaccia di Home Assistant.

Secondo LazyAdmin (2025), questa è la causa più frequente di schermo nero sul Pi 5 con la versione 18.

Diagnosticare il blocco dell’uscita video

Con Home Assistant OS 18 su Raspberry Pi 5, un bootloader precedente al 12 febbraio 2025 può causare un blocco dell’uscita video; il LED acceso e lo schermo fermo, da soli, non bastano a identificarlo come causa. Prima di intervenire sul software, conviene verificare che l’uscita video sia collegata correttamente e che il monitor accetti il segnale.

Primi passi dopo l’installazione

Dopo il primo accesso, Home Assistant richiede tre operazioni: collegare i dispositivi tramite integrazioni, creare una prima automazione e predisporre una copia di sicurezza. Conviene completarle in quest’ordine, perché le automazioni dipendono dalle entità che le integrazioni rendono disponibili.

Aggiunta di integrazioni e rilevamento dei dispositivi

Un’integrazione è il componente che permette a Home Assistant di comunicare con un dispositivo o un servizio. Home Assistant può rilevare automaticamente alcuni dispositivi presenti in rete e proporne la configurazione, mentre altri vanno aggiunti manualmente cercando la marca o il protocollo nell’elenco delle integrazioni disponibili.

• Un hub compatibile può esporre a Home Assistant i dispositivi associati, secondo le funzioni della relativa integrazione. Con un coordinatore Zigbee occorre associare i dispositivi alla rete; per Matter si configura l’integrazione e si aggiungono o condividono i dispositivi compatibili. Matter non richiede necessariamente un hub del produttore.
• Ogni dispositivo rilevato genera una o più entità (interruttori, sensori, luci), che sono gli elementi utilizzati nelle automazioni.
• Se un dispositivo non viene rilevato, la causa più comune è che si trovi su una rete o un protocollo non raggiungibile dalla scheda: conviene verificarlo prima di ripetere la ricerca.

Prima automazione: trigger, condizione e azione

Un’automazione in Home Assistant si compone di tre elementi, sempre nello stesso ordine di valutazione:

Una buona prima automazione usa un solo trigger e una sola azione, senza condizioni. Questo permette di verificare che l’entità sia collegata correttamente prima di aggiungere logiche più complesse. Le condizioni diventano utili quando l’automazione deve funzionare solo in certi momenti o stati della casa.

Backup automatici su una posizione esterna alla scheda

Un backup di Home Assistant contiene la configurazione, le automazioni e i dati salvati. Conservarlo sulla stessa scheda SD che esegue il sistema significa perderlo insieme al supporto in caso di guasto. Per questo conviene configurare la creazione automatica dei backup e impostare una destinazione esterna alla scheda, ad esempio un’unità di rete o un servizio di archiviazione cloud supportato dall’interfaccia.

Dalla sezione dedicata ai backup dell’interfaccia è possibile scegliere la frequenza di creazione e la posizione di salvataggio. Verifica periodicamente che il file più recente sia effettivamente presente nella destinazione scelta, perché un backup mai controllato non garantisce un ripristino funzionante.

Letture correlate

• Come integrare Alexa con Apple HomeKit: guida con Matter
• Lampadine smart compatibili con Google Home: requisiti e come verificarle
• Prese smart Wi-Fi senza hub compatibili con Alexa: guida pratica