Home Assistant [HA] é um controlador domótico. Uma plataforma, de código aberto (Open-Source), que permite automatizar tarefas quotidianas de casa: por exemplo, acender as luzes automaticamente quando nos aproximamos da nossa residência; verificar as condições de portas e janelas (se foram abertas “indevidamente”); ter uma temperatura adequada quando a família chegar… Vou mostrar como fiz a instalação de Home Assistant.
A instalação de Home Assistant…
…é muito simples e pode ser feita em vários ambientes e dispositivos: numa máquina virtual Windows, em macOS, em Linux, num computador portátil… Eu instalei-o num Raspberry Pi, seguindo este claríssimo tutorial em vídeo (o método que utilizo serve para instalar noutros dispositivos, como um computador com Ubuntu).
Como se pode ler na página oficial, dispomos de quatro métodos de instalação.
| OS | Container | Core | Supervised | |
|---|---|---|---|---|
| Automations | ✅ | ✅ | ✅ | ✅ |
| Dashboards | ✅ | ✅ | ✅ | ✅ |
| Integrations | ✅ | ✅ | ✅ | ✅ |
| Blueprints | ✅ | ✅ | ✅ | ✅ |
| Uses container | ✅ | ✅ | ❌ | ✅ |
| Supervisor | ✅ | ❌ | ❌ | ✅ |
| Add-ons | ✅ | ❌ | ❌ | ✅ |
| Backups | ✅ | ✅1 | ✅1 | ✅ |
| Managed OS | ✅ | ❌ | ❌ | ❌ |
Dois deles destinam-se a utilizadores experientes; como não é o meu caso, considero-os… para esquecer:
- Home Assistant Supervised: tem a grande vantagem de a instalação incluir todas as funcionalidades existentes do sistema operativo do HA. O (que poderá ser um) problema é que a gestão do sistema operativo será do utilizador, que deverá fazer atualizações.
- Home Assistant Core: apenas a versão core, programada em Python, pode ser executado em vários sistemas operativos. Não proporciona a experiência do Supervisor completa (nem o painel de Supervisor nem os complementos. É, talvez, a versão que exige mais conhecimentos técnicos).
Os outros dois são…
- HA Operating System: a versão mais completa. É um sistema operativo pequeno e otimizado que inclui o Supervisor para gestão da versão Core e add-ons pré-instalados, dispensando cuidados de gestão. No entanto, como corre exclusivamente o HA e os seus serviços, se se pretender usar o hardware para outras coisas além do HA, este não é o tipo de instalação recomendado..
- HA Container: a versão instalada por container docker; inclui apenas a versão core, sem a possibilidade de snapshots e add-ons. Mas tem a vantagem de poder ser usada num sistema operativo já existente, sem afetar o mesmo. Como já tinha instalado outros serviços no meu Raspberry Pi, optei por esta.
[Edição, a 20/4/2024: entretanto, reinstalei o Home Assistant (HA), mas agora a versão mais completa: HA Operating System. E de modo a que o HA arranque (num Raspberry Pi) a partir de um disco SSD. Escrevi um artigo sobre o tema, que está aqui]
Instalei o HA num Raspberry Pi…
…seguindo este claríssimo tutorial.
É tão simples como abrir um terminal (Ctrl+Alt+T)…
… mudar para super utilizador com o comando
sudo su
… atualizar o sistema com os comandos
apt update
apt upgrade
… se não estiver instalado ipbtables (verifique com o comando iptables -nvL), instalar com
apt install iptables
… se não tiver Docker instalado, instalar com o comando
apt install docker-compose
(verificar se está a funcionar, com o comando systemctl status docker)
… e instalar HA assim (ver detalhes aqui, na secção Install Home Assistant Container):
docker run -d \
–name homeassistant \
–privileged \
–restart=unless-stopped \
-e TZ=MY_TIME_ZONE \
-v /PATH_TO_YOUR_CONFIG:/config \
–network=host \
ghcr.io/home-assistant/home-assistant:stable
É necessário substituir MY_TIME_ZONE pela zona horária pretendida (por exemplo, Lisboa; está aqui uma lista das várias zonas); e PATH_TO_YOUR_CONFIG pela pasta pretendida para guardar as configurações (por exemplo, homeassistant/config). Feitas as alterações apresentadas como exemplo, teríamos…
docker run -d \
–name homeassistant \
–privileged \
–restart=unless-stopped \
-e TZ=Europe/Lisbon \
-v //root/homeassistant/config:/config \
–network=host \
ghcr.io/home-assistant/home-assistant:stable
…E temos o Home Assistant instalado.
Instalei o HA… e agora?
O vídeo HA do ZERO responde:
- Introdução; breve explicação sobre o HA
- Instalação do HA numa máquina virtual (em Windows)
- Configurações Básicas do HA (a partir dos 7 minutos): criar novo utilizador, por exemplo
||| Por favor, use a caixa de comentários para partilhar a sua experiência com o HA, para apontar algo que não esteja claro ou algo a corrigir ou a acrescentar. Obrigado.
||| Índice de artigos sobre o Home Assistant.
||| Índice de artigos sobre o Raspberry Pi.