Como Instalar o Home Assistant OS: Guia Passo a Passo [Episódio 2]

Instalar o Home Assistant OS parece intimidante, mas na prática são cerca de 20 minutos: gravar uma imagem, ligar um cabo de rede e abrir o browser. Os problemas aparecem quase sempre nos detalhes que os guias saltam, como a imagem errada para o teu modelo ou o IP que muda sozinho na semana seguinte.

Neste Episódio 2 da série Home Assistant do Zero à Prática, mostro como instalar o HAOS em cada um dos equipamentos que comparámos no Episódio 1: Raspberry Pi 4 ou 5, Raspberry Pi 3, mini PC e Home Assistant Green. No fim, tens o sistema a correr, com IP fixo e a primeira cópia de segurança feita.

O que precisas antes de começar

• O equipamento onde vai correr o Home Assistant, com a fonte de alimentação certa. No Raspberry Pi, usa a fonte oficial: carregadores de telemóvel e portas USB do computador não dão potência suficiente ou podem dar potência instável o que prejudica o correto funcionamento.
• Um cabo de rede ligado ao router. É obrigatório durante a instalação e, depois, continua a ser a opção mais fiável.
• Um cartão microSD de 32 GB ou mais (a nossa recomendação é classe A1/A2 high endurance) ou, melhor ainda, um SSD por USB, se usares um Raspberry Pi.
• Um computador para gravar a imagem e para aceder ao Home Assistant pela primeira vez.
• Ligação à internet: no primeiro arranque, o sistema descarrega a versão mais recente do Home Assistant.

Instalar o Home Assistant num Raspberry Pi 4 ou 5

Este é o caminho mais simples, porque o Raspberry Pi Imager já traz o Home Assistant no menu.

1. Descarrega e instala o Raspberry Pi Imager no teu computador, a partir do site oficial da Raspberry Pi.
2. Abre o Imager e escolhe o sistema operativo: Other specific-purpose OS > Home automation > Home Assistant.
3. Escolhe a imagem que corresponde ao teu modelo (RPi 4 ou RPi 5).
4. Insere o cartão (ou o SSD) no computador e seleciona-o como destino. Atenção: todo o conteúdo vai ser apagado.
5. Carrega em Next e depois em Write. Espera que a gravação termine e ejeta o cartão.
6. Coloca o cartão no Raspberry Pi, liga o cabo de rede e, por fim, a alimentação.

Num Pi 4 ou 5, o ecrã de boas-vindas costuma estar disponível em cerca de um minuto. Se passados 5 minutos não aparecer nada, o mais provável é a gravação ter falhado: volta a gravar o cartão ou experimenta outro.

Instalar o Home Assistant num Raspberry Pi 3

Foi aqui que encontrámos a primeira surpresa: o Raspberry Pi Imager já só mostra imagens para o Pi 4 e o Pi 5. O Pi 3 continua a ter imagem oficial do Home Assistant OS, só que tens de a ir buscar à mão.

1. Abre a página de versões (releases) do Home Assistant Operating System no GitHub.
2. Na versão mais recente, expande a lista de ficheiros e descarrega o que tem o nome haos_rpi3-64-(número da versão).img.xz. Confirma que é a variante 64: a de 32 bits já não recebe atualizações.
3. Instala o Balena Etcher (ou usa a opção "Use custom" do Raspberry Pi Imager) e grava o ficheiro no cartão.
4. Coloca o cartão no Pi 3, liga o cabo de rede e a alimentação.

Tem paciência no primeiro arranque: num Pi 3 o processo demora bastante mais do que num Pi 4 ou 5, porque tem de descarregar e preparar tudo com apenas 1 GB de RAM. Vale a pena deixar o sistema trabalhar sem desligar.

Instalar o Home Assistant num mini PC

Num mini PC, o Home Assistant OS substitui por completo o sistema operativo que lá estiver. Faz cópia de tudo o que precisares antes de começar.

1. Preparar a BIOS

1. Liga o mini PC e carrega várias vezes em F2 (em alguns modelos é Del, F1 ou F10) para entrar na BIOS.
2. Confirma que o modo de arranque UEFI está ativo.
3. Desativa o Secure Boot.
4. Grava e sai.

2. Gravar o HAOS no disco interno (método recomendado)

1. Noutro computador, cria uma pen USB de arranque com o Ubuntu Desktop (8 GB chegam).
2. Arranca o mini PC pela pen e escolhe Try Ubuntu, não "Install Ubuntu".
3. Já no Ubuntu, liga-te à rede e descarrega a imagem haos_generic-x86-64 da página oficial de instalação.
4. Abre a aplicação Discos (Disks), seleciona o disco interno, abre o menu dos três pontos e escolhe Restaurar imagem de disco (Restore Disk Image).
5. Seleciona a imagem que descarregaste e confirma o restauro.
6. Quando terminar, desliga o Ubuntu, retira a pen e volta a ligar o mini PC com o cabo de rede ligado.

Nota: alguns SSD NVMe usam setores nativos de 4K e o Home Assistant OS não arranca a partir deles. A maioria dos discos não tem este problema, mas se o mini PC disser que não encontra disco de arranque, é uma das primeiras coisas a verificar.

Home Assistant Green

Aqui não há nada para instalar. Liga o cabo de rede, liga a alimentação e passa diretamente para o passo seguinte.

Primeiro acesso e configuração inicial

Com o equipamento ligado, abre o browser num computador da mesma rede e escreve:

http://homeassistant.local:8123

Se não abrir, experimenta http://homeassistant.local ou o IP do equipamento seguido de :8123 (encontras o IP na lista de dispositivos ligados do teu router).

Vais ver o assistente de configuração inicial (onboarding). Os passos são:

1. Criar a tua casa nova ou restaurar uma cópia de segurança. Se estás a mudar de hardware, é aqui que restauras o backup do sistema antigo.
2. Criar o utilizador administrador. Usa uma palavra-passe forte e guarda-a num gestor de palavras-passe.
3. Localização, fuso horário e unidades. Indica a localização real da casa: é usada para o nascer e o pôr do sol, meteorologia e automações de presença.
4. Partilha de dados anónimos, que é opcional.
5. Dispositivos encontrados. O Home Assistant deteta automaticamente muita coisa na rede (Smart TV, impressoras, Chromecast, routers). Podes configurá-los já ou mais tarde.

Reservar um IP fixo no router

Este é o passo que quase todos os guias saltam e que mais dores de cabeça evita. Por defeito, o router atribui um IP dinâmico ao Home Assistant, que pode mudar depois de um corte de luz. Se isso acontecer, as apps no telemóvel, os favoritos no browser e algumas integrações deixam de o encontrar.

1. Entra na página de administração do teu router (normalmente 192.168.1.1 ou 192.168.0.1).
2. Procura a secção DHCP, LAN ou Reserva de endereços.
3. Encontra o equipamento "homeassistant" na lista e reserva o IP que ele tem atualmente.
4. Grava e reinicia o Home Assistant em Definições > Sistema, no menu dos três pontos.

Os menus variam muito entre routers de operadoras (MEO, NOS, Vodafone, DIGI) e routers próprios, mas a opção existe em praticamente todos.

A primeira cópia de segurança

Antes de começares a experimentar, faz uma cópia de segurança. Vai a Definições > Sistema > Cópias de segurança e cria uma agora. Configura também as cópias automáticas e guarda a chave de encriptação num local seguro: sem ela, não consegues restaurar a cópia noutro equipamento.

No Raspberry Pi com cartão SD isto é especialmente importante. Quando um cartão falha, a cópia de segurança é a diferença entre 10 minutos de restauro e recomeçar do zero.

Erros comuns e soluções

• homeassistant.local não abre: usa o IP direto com :8123. Algumas versões do Windows e redes mais restritas não resolvem nomes ".local".
• O Raspberry Pi não arranca (só a luz vermelha acesa): imagem errada para o modelo ou gravação falhada. Confirma a variante (rpi3-64, rpi4-64 ou rpi5-64) e grava de novo.
• O mini PC diz que não há disco de arranque: confirma o UEFI e o Secure Boot desligado. Se continuar, pode ser preciso adicionar manualmente a entrada de arranque EFI na BIOS.
• Fica eternamente em "A preparar o Home Assistant": verifica a ligação à internet. O primeiro arranque precisa de descarregar componentes.
• Raspberry Pi reinicia sozinho: quase sempre é a fonte de alimentação.

Perguntas frequentes

Quanto tempo demora a instalar o Home Assistant?

A gravação da imagem e a configuração inicial levam cerca de 20 a 30 minutos. O primeiro arranque demora cerca de um minuto num Raspberry Pi 4 ou 5 e bastante mais num Raspberry Pi 3.

Posso instalar o Home Assistant no Raspberry Pi 3?

Sim. Continua a existir uma imagem oficial de 64 bits para o Pi 3, mas já não aparece no Raspberry Pi Imager. Tens de descarregar o ficheiro haos_rpi3-64 da página de versões do Home Assistant OS no GitHub e gravá-lo com o Balena Etcher.

Posso ligar o Home Assistant por Wi-Fi?

Durante a instalação é obrigatório usar cabo de rede. Depois podes configurar o Wi-Fi, mas a ligação por cabo continua a ser a mais fiável e é a recomendada.

Cartão SD ou SSD para o Home Assistant?

Um SSD é sempre a melhor opção, porque o Home Assistant escreve dados constantemente e os cartões SD acabam por falhar. Se usares cartão, escolhe um de classe A2 com pelo menos 32 GB e mantém as cópias de segurança automáticas ativas.

No próximo episódio

Com o Home Assistant a correr, está na hora de lhe dar sentidos. No Episódio 3: O Fim dos Conflitos no Wi-Fi, explicamos porque deves apostar em Zigbee e Matter e como configurar a tua primeira antena coordenadora.

Conseguiste instalar à primeira? Conta-nos nos comentários em que equipamento e se encontraste algum problema.