O Home Assistant, servidor de automação residencial open source, possui diversos métodos de instalação, sendo que o mais completo e simples é por meio da imagem de um sistema operacional especifico para este trabalho.
Apesar de ser mais simples a instalação e o método recomendado pelos desenvolvedores, quando você precisa instalar no mesmo equipamento outros aplicativos fora do ecossistema do home-assistant você passa a ter uma dificuldade a mais.
E neste ponto que temos a vantagem de utilizar o 2o método mais completo que é o Supervised.
Guia com base na placa RASPBERRY PI4 de 4Gb, mas deve funcionar bem com placas compatíveis ou o Raspberry Pi3 e para testes com o Raspberry Pi2.
1 - Instalação do Sistema Operacional - Raspberry OS
Siga as instruções em https://www.raspberrypi.org/software/
2 - Permitir acesso SSH ao novo sistema
a) crie na partição/volume boot um arquivo texto, vazio e sem extensão chamado ssh.
3 - Primeiro Boot
a) Coloque o micro-sd no seu RP4 e ligue.
b) Tenha certeza que o RP4 está ligado fisicamente a uma conexão ethernet.
c) Aguarde 5 minutos para que o boot esteja completo.
4 - Primeiro Logon
a) No seu servidor DHCP, ou roteador, verifique qual foi o endereço atribuído pela sua rede ao RP4. No nosso tutorial, vamos considerar que seja o 192.168.50.20.
b) Com um cliente SSH, conecte ao endereço recebido pela placa
ssh pi@192.168.50.20
c) Para login, use o usuário e senha padrão do sistema:
- user: pi
- password: raspberry
5 - Atualize o sistema operacional e os pacotes e instale as dependências
a) sudo apt-get update && sudo apt-get upgrade -y
b) Instale o AppArmor, Network Manager e jq:
sudo apt-get install network-manager apparmor-utils jq -y
c) Reinicie o equipamento:
sudo reboot
6 - Instalação do gerenciador de containers Docker
a) Download do script de instalação
curl -fsSL https://get.docker.com -o get-docker.sh
b) Executar o script de instalação
sudo sh get-docker.sh
c) adicionar o seu usuário ao grupo Docker, substitua "pi" caso seu usuário não seja "pi".
sudo usermod -aG docker pi
d) verificar se sua instalação do docker está ok
docker -v
resposta:
Docker version 20.10.6, build 370c289
7 - Script de instalação oficial do Home Assistant Supervised
a) Download do script de instalação
sudo curl -Lo installer.sh https://raw.githubusercontent.com/home-assistant/supervised-installer/master/installer.sh
b) Opções que equipamento para a instalação. Escolha uma de acordo com sua configuração:
intel-nuc qemux86-64 odroid-c2 raspberrypi odroid-n2 raspberrypi2 odroid-xu raspberrypi3
qemuarm raspberrypi4 qemuarm-64 raspberrypi3-64 qemux86 raspberrypi4-64 tinker
c) Execute o script de instalação, alterando o parâmetro conforme escolhido no item anterior.
sudo bash installer.sh --machine raspberrypi4
d) Na pergunta a seguir escolha SIM, teclando y.
Do you want to proceed with overwriting the /etc/network/interfaces file? [N/y]
e) Se tudo der certo, você irá ver o resultado a seguir, com o IP e porta de acesso a interface do Home Assistant.
8 - Primeiro acesso a configuração
a) Por meio de um navegador, abra o endereço apresentado. Ex. http://192.168.50.20:8123
b) O primeiro acesso demora por volta de 20 minutos para ficar disponível. Enquanto isto você visualiza a seguinte tela de instalação:
9 - Configuração do home assistant ou Hass.io.
a) Ao ver no navegador a tela a seguir, indica que a sua instalação foi provavelmente bem sucedida.