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