Negli ultimi anni Home Assistant si è affermato come una delle soluzioni più complete e flessibili per la domotica fai-da-te.
Grazie alla sua natura open-source e alla possibilità di integrarsi con centinaia di dispositivi smart consente di centralizzare il controllo della casa intelligente in un’unica interfaccia.
In questa guida vedremo come installare e configurare Home Assistant su un Raspberry Pi trasformandolo in un sistema kiosk: un’interfaccia dedicata e sempre attiva, perfetta da usare come pannello di controllo montato a parete o su un tablet.
Ti accompagnerò passo dopo passo dall’installazione del sistema operativo fino alla configurazione dell’avvio automatico e dell’interfaccia kiosk per ottenere un setup stabile, funzionale e dal look professionale.
PREREQUISITI
Per realizzare questo progetto servono:
- Raspberry Pi 4 o superiore
- Scheda microSD (minimo 16 GB, classe 10)
- Display HDMI Touch
- Sistema operativo Raspberry Pi OS (Bookworm o superiore, con desktop)
- Connessione Internet attiva
NOTA BENE: La configurazione di Home Assistant è indipendente dal progetto kiosk, qui gestiamo solo l’installazione e l’avvio automatico su schermo touch.
AGGIORNAMENTO DEL SISTEMA
Aggiornare l’intero sistema operativo per garantire compatibilità e stabilità.
|
0 |
sudo apt update && sudo apt upgrade -y |
Installare i pacchetti necessari:
- vim → editor di testo
- chromium → browser in modalità kiosk
- unclutter → rimuove il cursore del mouse dopo un periodo di inattività
- x11-xserver-utils → comandi per la gestione del display
- curl → per scaricare Docker
|
0 |
sudo apt install -y vim chromium unclutter x11-xserver-utils curl |
INSTALLAZIONE DI DOCKER
Scaricare lo script ufficiale di installazione Docker con il comando:
|
0 |
curl -fsSL https://get.docker.com -o get-docker.sh |
Eseguire lo script con il comando:
|
0 |
sudo sh get-docker.sh |
Aggiungi il tuo utente al gruppo docker per poter eseguire i comandi senza sudo:
|
0 1 |
sudo usermod -aG docker $USER newgrp docker |
INSTALLAZIONE DI HOME ASSISTANT
Avvia il container Docker di Home Assistant.
Il volume /home/pi/homeassistant conterrà la configurazione locale.
|
0 1 2 3 4 5 6 7 |
docker run -d \ --name homeassistant \ --privileged \ --restart=unless-stopped \ -e TZ=Europe/Rome \ -v /home/pi/homeassistant:/config \ --network=host \ ghcr.io/home-assistant/home-assistant:stable |
Controllare che il container sia in esecuzione con il comando:
|
0 |
docker ps |
Dopo pochi minuti Home Assistant sarà accessibile da browser all’indirizzo:
http://localhost:8123
CREAZIONE DELLA CARTELLA SCRIPT
Creare una cartella dedicata agli script di sistema, con permessi sicuri e condivisibili con i seguenti comandi:
|
0 1 2 |
sudo mkdir /script sudo chmod +t /script sudo chmod 1777 /script |
CREAZIONE DELLO SCRIPT DI AVVIO KIOSK
Editare il file con il comando:
|
0 |
vim /script/start-kiosk.sh |
Incollare questo contenuto:
|
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
#!/bin/bash export DISPLAY=:0 # Attende che il server X sia pronto while ! xset q &>/dev/null; do sleep 1 done # Attende che il display HDMI sia connesso while ! xrandr | grep -q ' connected'; do sleep 1 done # Attende che la risoluzione corretta sia applicata while ! xrandr | grep -q '400x1280'; do sleep 1 done # Avvia Chromium in modalità kiosk su Home Assistant nohup chromium --kiosk http://localhost:8123 \ --disable-logging \ --noerrdialogs \ --password-store=basic \ --start-fullscreen \ --incognito >/dev/null 2>&1 & # Scollega il processo dalla shell disown |
Salva e chiudere il file di configurazione
Rendere lo script eseguibile con i comandi:
|
0 1 |
sudo chmod +x /script/start-kiosk.sh sudo chmod 755 /script |
AVVIO AUTOMATICO DEL KIOSK ALL’ACCESSO
Crea il file .desktop per avviare automaticamente lo script all’avvio del sistema grafico.
Editare il file kiosk.desktop con il comando:
|
0 |
sudo vim /etc/xdg/autostart/kiosk.desktop |
Inserire il seguente contenuto:
|
0 1 2 3 4 |
[Desktop Entry] Type=Application Name=Kiosk Exec=/script/start-kiosk.sh X-GNOME-Autostart-enabled=true |
Salvare e chiudere il file di configurazione
ABILITAZIONE AUTO LOGIN (FACOLTATIVO)
Se non è già configurato, abilitare il login automatico per l’utente pi (o l’utente, se ne usi uno dedicato).
Apri il file di configurazione LightDM con il comando:
|
0 |
sudo vim /etc/lightdm/lightdm.conf |
Aggiungere o modificare le seguenti righe:
|
0 1 2 |
[Seat:*] autologin-user=pi autologin-session=lightdm-autologin |
Salvare e chiudere il file di configurazione
Dopo il riavvio, il sistema entrerà direttamente nel desktop e avvierà il kiosk.
VERIFICA FINALE
Riavvia il Raspberry Pi con il comando:
|
0 |
sudo reboot |
All’avvio:
Verrà eseguito l’auto-login
Lo script /script/start-kiosk.sh attenderà il caricamento del display
Chromium partirà in modalità kiosk e aprirà automaticamente Home Assistant su http://localhost:8123
0 commenti