Come installare e configurare Home Assistant (HASSIO) con Docker su un Raspberry Pi già in uso

SCOPI DELLA GUIDA:
  • Installare e configurare Home Assistant in modalità HASSIO su Docker, quindi dotarsi di tale HUB personale senza perdere le funzionalità offerte dal sistema operativo Raspbian
  • Livello di difficoltà: basso
CONCETTI AFFRONTATI:
  • installazione e configurazione software
COMPONENTI SOFTWARE UTILIZZATE:
PREREQUISITI:
DISPOSITIVI FISICI UTILIZZATI:
GUIDA MAGGIORMENTE INDICATA PER:

Tutti gli ambienti

Note e disclaimer
  • qualsiasi modifica all'impianto elettrico dev'essere effettuata da personale qualificato
  • qualsiasi modifica attuata in proprio è a propria responsabilità personale nonché a proprio rischio e pericolo (la presente guida ha puro scopo didattico)
  • qualsiasi modifica attuata in proprio a un dispositivo ne fa decadere la garanzia.
Revisione guida: 1.3

Abstract

Come spiegato in altre schede, Home Assistant è il uno tra gli HUB personali ideali per realizzare una propria domotica personale in modo organico e funzionale. Questo cruciale componente software ha la possibilità di essere installato su molti sistemi e in modalità diverse: su Raspberry Pi la modalità solitamente più caldeggiata dagli sviluppatori è la modalità “HASSIO”, ovvero una modalità sì completamente automatica, la quale prevede però di dedicare il Raspberry Pi all’uso esclusivo di Home Assistant, chiudendo di fatto ad eventuali altre funzionalità. Questa modalità è descritta in questa guida specifica.

L’installazione di Home Assistant in modalità HASSIO ha sì lo svantaggio di dedicare una unità Raspberry al suo uso esclusivo, ma presenta il vantaggio di fornire all’utente, nell’uso ordinario, un elemento assente in altre tipologie di installazione: “l’add-on store“. Si tratta, in sostanza, di un elenco di componenti aggiuntive (MQTT, Samba, SSH, Node-RED e molti altri) installabili e configurabili direttamente dall’interfaccia di Home Assistant, rendendo molto più semplice la personalizzazione dell’HUB.

Un’installazione tradizionale (Raspberry con sistema operativo Raspbian + Home Assistant installato a mano) rende il Raspberry disponibile anche ad altri usi paralleli, ma prevede che Home Assistant (ed eventuali componenti aggiuntive) vengano completamente installate e configurate manualmente.

La soluzione che salva capra e cavoli esiste, ed è descritta nella presente guida.

In pratica si tratta di installare Raspberry in modalità convenzionale (con sistema operativo Raspbian) aggiungendovi poi un contenitore (“container”) dentro il quale eseguire HASSIO. Un container è un ambito virtuale che “fa credere” a HASSIO di trovarsi in un ambiente tutto suo, come appunto un Raspberry ad esso dedicato: questo ne permette l’esecuzione e, al contempo, lascia all’utente lo “spazio di manovra” auspicato presso il sistema operativo Raspbian. La tipologia di container utilizzata sarà Docker.

N.b. La modalità di installazione descritta in questa guida è funzionante, certificata, SOLO su Raspberry modello 3B, 3B+ o superiori.


Una lista delle possibili alternative d’installazione è disponibile qui.

Home Assistant Official Logo

 

Procedimento

Installare Raspbian

Questa guida è dedicata a chi abbia già un Raspberry in uso con sistema operativo Raspbian. Per coloro che non abbiano ancora provveduto e si trovino ad avere un Raspberry nuovo, magari acquistato appositamente per realizzare la propria domotica, allora questo passo della guida va smarcato seguendo prima un’altra guida, che spiega passo passo come configurare il sistema operativo Raspbian.

La guida da seguire:

Una volta terminata la configurazione di Raspbian, è possibile procedere nella presente guida.

Docker

INSTALLAZIONE

Una volta collegati via ssh al proprio Raspberry (utilizzando l’utenza “pi”), eseguire innanzitutto un aggiornamento dell’ambiente:

sudo apt-get update -y
sudo apt-get upgrade -y 
sudo rpi-update -y
sudo reboot

successivamente al riavvio causato dall’ultimo comando, eseguire il seguente comando:

curl -fsSL get.docker.com -o get-docker.sh && sudo sh get-docker.sh

il quale provvederà ad installare Docker.
Successivamente, installeremo tutte le dipendenze necessarie:

sudo apt-get install socat jq curl avahi-daemon dbus -y
CONFIGURAZIONE

A questo punto dobbiamo perfezionare la configurazione. Modificheremo quindi il file “/boot/cmdline.txt“:

sudo nano /boot/cmdline.txt

Nell’editor che apparirà, posizioniamoci sul fondo del testo e aggiungiamo la seguente riga:

cgroup_enable=memory cgroup_memory=1

Usciamo e salviamo (CTRL+X, Y, Invio).
Infine, riavviamo il Raspberry per rendere effettive le modifiche:

sudo reboot

Installare HASSIO

Terminato il riavvio, ricolleghiamoci via SSH al nostro Raspberry e diventiamo superuser:

sudo su

e lanciamo l’installazione di HASSIO:

curl -sL https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh | bash -s -- -m raspberrypi3

A questo punto prendiamoci una pausa: l’attività che segue potrebbe metterci fino a 20-25 minuti, dipendentemente dalla velocità della vostra connessione Internet e dalle prestazioni del Raspberry.

Al termine, il terminale riporterà la seguente dicitura:

[Info] Run Hass.io

la quale identifica il completamento dell’attività.

Primo accesso su Home Assistant

Al termine della procedura, HASSIO sarà finalmente in esecuzione sul nostro Raspberry. Per scoprire l’IP del Raspberry sarà sufficiente eseguire il comando:

ifconfig

il quale elencherà gli IP associati al raspberry:

Raspbian ifconfig

L’indirizzo IP è solitamente indicato a destra della dicitura “inet” e, solitamente, fa parte della subnet 192.168.0.0/16.
Scoperto l’IP, accedere ad HASSIO indicando sul proprio browser il seguente indirizzo:

http://indirizzo_ip_raspberry:8123

oppure

http://hassio.local:8123

Dove indirizzo_ip_raspberry è, appunto, l’indirizzo IP assegnato al Raspberry.

Configurare accessori domotici

Ora è possibile cominciare a configurare i primi accessori della propria domotica. Per far ciò è necessario effettuare delle modifiche al file “configuration.yaml“, il quale si trova nella cartella “usr/share/hassio“.

Al tema relativo al file di configurazione di Home Assistant dedichiamo una guida apposita.

LOG

Per visualizzare i LOG dell’installazione hassio, utilizzare il seguente comando:
sudo docker logs hassio_supervisor

Home Assistant su Raspberry Pi: le varie installazioni, le cose da fare


Home Assistant Official LogoATTENZIONE: ricorda che sul nostro community FORUM c'è una sezione ad hoc dedica a Home Assistant, per qualsiasi dubbio, domanda, informazione nel merito specifico di queste componenti.

🔻 Clicca QUI per commentare l'articolo. 🔻