O que você vai precisar
Na bancada ao lado do roteador, com um cabo Ethernet curto e uma fonte que não chia, o Home Assistant começa a mostrar se vai virar central de automação ou mais um experimento largado na gaveta. O software é ótimo. A instalação feita no improviso, nem tanto.
Vou usar um caso bem comum no Brasil: apartamento de 70 m², roteador da operadora na sala, lâmpadas Wi-Fi espalhadas, alguns sensores Zigbee esperando um coordenador USB e a ambição saudável de controlar tudo sem depender da nuvem de cinco fabricantes. É o cenário de muita gente que chega ao Home Assistant depois de cansar do app Tuya, do app da lâmpada, do app da câmera e de mais três senhas esquecidas.
Home Assistant OS é a instalação certa para quase todo mundo#
Home Assistant não é um aplicativo para instalar em qualquer computador da casa e fechar depois. Pense nele como um servidor doméstico: ele fica ligado 24 horas, conversa com sensores, recebe eventos, executa automações e mostra o painel no navegador ou no celular. Por isso a escolha do tipo de instalação pesa mais do que parece.
Para começar, minha recomendação é direta: use Home Assistant OS. É a versão que já traz Home Assistant Core, Supervisor, add-ons, backups pelo painel e atualizações sem você virar administrador Linux no domingo à noite. Container em Docker faz sentido para quem já administra servidores e sabe mapear portas, volumes e dispositivos USB. Para o primeiro setup sério de casa inteligente, Home Assistant OS dá menos margem para erro.
A documentação oficial trata o Home Assistant OS como o caminho recomendado para a maioria dos usuários. Em Raspberry Pi, o básico aceito hoje é Pi 4 ou Pi 5 com fonte adequada, pelo menos 2 GB de RAM, cartão microSD e rede Ethernet. Em mini PC x86-64, o processo muda: você prepara BIOS, grava a imagem no disco de boot e dedica a máquina ao Home Assistant.
Passo a passo
1. Escolha o hardware antes de gravar a imagem
O Raspberry Pi ainda é a porta de entrada mais conhecida, e funciona bem para uma casa pequena ou média. Só que existe uma diferença brutal entre testar com 10 dispositivos e morar com 80 entidades, histórico, automações, Zigbee2MQTT, backups e banco de dados crescendo mês após mês. O gargalo aparece primeiro no armazenamento.
Cartão microSD barato é a economia que costuma cobrar juros. Para laboratório, um microSD A2 de 32 GB resolve. Para uso diário, prefira SSD. Em mini PC usado, um SSD SATA ou NVMe de 120 GB já deixa o Home Assistant mais folgado do que a maioria dos setups domésticos precisa. E o mini PC tem uma vantagem clara: aguenta melhor add-ons, banco de dados maior e integrações mais pesadas, consumindo algo na faixa de 6 a 15 W em muitos modelos compactos.
No nosso apartamento de referência, eu iria de mini PC x86-64 se o orçamento permitir. Não porque o Raspberry Pi seja ruim, mas porque o Home Assistant cresce. Primeiro vem a lâmpada da sala. Depois entram sensores de porta, presença, energia, ar-condicionado, câmera, fechadura e uma automação que ninguém quer perder quando o cartão SD cansar.
Dica: Até 30 dispositivos e poucas automações, Raspberry Pi 4 ou 5 resolve. Acima disso, ou se você pretende usar câmeras, histórico longo e vários add-ons, compre um mini PC usado com SSD antes de comprar mais lâmpadas.2. Grave o Home Assistant OS no cartão, SSD ou disco interno
No Raspberry Pi, o caminho mais limpo é abrir o Raspberry Pi Imager, escolher “Other specific-purpose OS”, entrar em “Home automation” e selecionar Home Assistant. Depois escolha a versão compatível com o seu Pi, selecione o cartão ou SSD e grave. O conteúdo do armazenamento será apagado. Parece óbvio, mas todo mês aparece alguém formatando o cartão errado.
Se o Imager não estiver disponível no seu computador, o Balena Etcher também resolve. Baixe a imagem correta no site do Home Assistant, grave no cartão ou disco e ejete com segurança. Não use imagem antiga guardada na pasta Downloads, porque Home Assistant OS muda bastante ao longo do ano. Em 2026, a instalação viva é a que você baixa na hora.
No mini PC x86-64, o cuidado muda de lugar. Entre na BIOS, habilite UEFI e desative Secure Boot. Depois grave o Home Assistant OS no SSD ou disco interno usando o método recomendado pela documentação, normalmente com um pendrive de Ubuntu ou ferramenta de gravação. Disco USB externo até funciona em alguns casos, mas eu não colocaria a automação da casa inteira pendurada em um cabo que alguém pode esbarrar limpando a mesa.
Dica: Confira o disco antes de gravar. Balena Etcher, Raspberry Pi Imager e utilitários de disco apagam o destino inteiro. Selecione o cartão, SSD ou disco correto. Um clique errado pode apagar o HD do computador.3. Ligue por cabo de rede e aguarde a porta 8123 responder
Coloque o cartão ou SSD no Raspberry Pi, ou ligue o mini PC já com o disco gravado. Conecte Ethernet antes da energia. Para a primeira inicialização, Wi-Fi é pedir para sofrer: mDNS falha, DHCP demora, repetidor de sinal cria outra rede e você acaba culpando o Home Assistant por um problema que nasceu no roteador.
Depois de ligar, aguarde alguns minutos e abra no navegador: http://homeassistant.local:8123. Se não abrir, tente http://homeassistant:8123. Se ainda assim nada aparecer, entre na página de dispositivos conectados do roteador e procure por “homeassistant” ou por um novo IP na rede. A interface web roda na porta 8123; quando você acessa pelo IP, o formato fica parecido com http://192.168.1.50:8123.
Aqui o tutorial deixa de ser instalação de software e vira infraestrutura de casa.
Se um Raspberry Pi 4 ou 5 não mostra a tela inicial depois de 5 minutos, desconfie da gravação, do cartão, da fonte ou do cabo de rede antes de mexer em qualquer arquivo. Regravar a imagem do zero costuma resolver mais rápido do que caçar erro invisível. No mini PC, confira também se a BIOS está dando boot pelo disco certo.
4. Faça o onboarding sem restaurar configurações velhas por impulso
A primeira tela pede criação de usuário, nome da casa, localização, fuso horário e unidades. Preencha com cuidado. A localização define nascer e pôr do sol, clima local e automações baseadas em presença. Não use “Casa” como nome de tudo. Dê ao servidor um nome simples, como “ha-apartamento” ou “ha-casa”, porque esse nome aparece em backups, rede e integrações.
Se você está migrando de outro Home Assistant, o onboarding permite restaurar backup. Só faça isso quando tiver certeza de que o backup é recente e limpo. Ao migrar com coordenador Zigbee, rádio Thread ou stick Z-Wave, conecte esses rádios no novo hardware antes de restaurar. A restauração pode recuperar muita coisa, mas não faz milagre se o caminho USB mudou e você não sabe qual dongle era qual.
Se é a primeira instalação, resista à pressa. Termine o onboarding, entre no painel e olhe as integrações descobertas automaticamente. Home Assistant costuma encontrar TVs, impressoras, Chromecast, roteadores, lâmpadas e serviços da rede. Não aceite tudo no piloto automático. Cada integração adicionada vira entidade, notificação e ruído.
5. Atualize Core, Supervisor e sistema antes de instalar add-ons
Depois de entrar no painel, vá para as configurações e veja se há atualização de Core, Supervisor, sistema operacional ou firmware. Atualize antes de instalar add-ons. É chato? Um pouco. Mas é pior montar Zigbee2MQTT, MQTT broker, HACS, dashboards e integrações para descobrir que um update pendente mexia justamente no Supervisor.
Meu conselho é instalar pouco no primeiro dia: File editor ou Studio Code Server, Terminal & SSH apenas se você sabe por que precisa, e um broker MQTT se for usar Zigbee2MQTT. HACS pode esperar. Ele é útil, abre um universo de integrações e cartões, mas também é a maneira mais rápida de transformar uma instalação nova em um Frankenstein cheio de dependências não oficiais.
Dica: Não comece pelo HACS. HACS é ótimo quando você já entende o básico do Home Assistant. No primeiro dia, ele aumenta a chance de instalar cartão visual, integração customizada e tema antes de ter backup, nomes decentes e automações testadas.6. Adicione Wi-Fi, Zigbee e Matter em uma ordem controlada
Comece pelo que o Home Assistant descobriu sozinho na rede. Dispositivos Wi-Fi locais, como algumas TVs, caixas de som, impressoras e hubs, aparecem sem drama quando estão na mesma sub-rede. Produtos que dependem de cloud continuam dependendo da cloud; Home Assistant não transforma todo Wi-Fi barato em automação local. Ele integra o que o fabricante deixa integrar.
Depois parta para Zigbee ou Matter, se esse é o seu plano. Um coordenador Zigbee/Thread USB deve ficar em uma extensão curta, longe da porta USB 3.0 do mini PC e longe do roteador Wi-Fi. Parece superstição de fórum, mas não é: interferência em 2,4 GHz existe, cabo USB ruim existe e caixa metálica de mini PC também não ajuda. Deixe o rádio respirar.
Para Zigbee, escolha entre ZHA e Zigbee2MQTT. ZHA é mais simples, integrado ao Home Assistant e suficiente para muita casa. Zigbee2MQTT dá mais controle, compatibilidade ampla e diagnóstico melhor, mas exige MQTT e um pouco mais de paciência. Eu uso Zigbee2MQTT em setup grande. Para a primeira instalação de meia dúzia de sensores, ZHA é uma escolha honesta.
Matter ainda depende muito da qualidade do dispositivo e do ecossistema de borda que você já tem. Funciona melhor quando a rede IPv6 está saudável e quando Thread border routers estão bem posicionados. Se a sua rede doméstica é uma mistura de roteador da operadora, repetidor antigo e senha compartilhada com a família inteira há seis anos, arrume a rede antes de culpar o protocolo.
7. Organize áreas, nomes e painel antes de criar automações
Antes da primeira automação, organize áreas. Sala, cozinha, suíte, banheiro social, varanda e corredor são áreas; “luz”, “sensor” e “tomada” não são. Depois renomeie entidades com nomes que você falaria em voz alta: “Luz da bancada”, “Sensor porta varanda”, “Tomada cafeteira”. O painel fica mais limpo e a assistente de voz erra menos.
O erro clássico é aceitar nomes vindos do fabricante: light.tuya928374switch1, sensor.motionias_zone e outros cadáveres digitais. Quando você deixa isso acumular, cada automação vira arqueologia. Gaste 20 minutos renomeando agora para não perder duas horas daqui a três meses.
No painel, comece com uma visão simples: cartões por ambiente, estados que você consulta todo dia e botões realmente úteis. Dashboard bonito demais no primeiro fim de semana costuma esconder uma casa mal configurada. A melhor tela inicial é aquela que mostra se a porta está aberta, se a luz ficou ligada, se alguém está em casa e se o servidor está saudável.
8. Crie backup e teste o plano de recuperação
Com o sistema instalado, atualizado e minimamente organizado, crie um backup completo. Baixe esse arquivo para o computador e guarde fora do cartão ou SSD do Home Assistant. Backup que mora no mesmo dispositivo que pode falhar é só uma promessa bonita.
Na migração para outro hardware, o Home Assistant permite restaurar backup durante o onboarding, inclusive enviando o arquivo pelo navegador. Isso simplifica bastante a troca de Raspberry Pi para mini PC. O detalhe que separa restauração tranquila de noite perdida é físico: rádios USB conectados, portas identificadas e backup recente.
Minha rotina mínima: backup antes de grandes atualizações, backup antes de instalar add-on crítico e backup depois de terminar uma rodada de novas integrações. Não precisa virar paranoia. Precisa virar hábito.
Os erros mais comuns aparecem antes da primeira automação#
Se http://homeassistant.local:8123 não abre, o primeiro suspeito é a resolução de nome na rede, não o Home Assistant. Teste pelo IP. Se pelo IP funciona, o problema é mDNS ou configuração do roteador. Se nem o IP aparece no roteador, confira cabo, porta LAN, fonte e gravação da imagem.
Se o sistema reinicia sozinho, troca de fonte antes de culpar o software. Raspberry Pi com fonte fraca vira loteria: liga, cai, corrompe cartão e ainda deixa você achando que a integração da lâmpada era o problema. No mini PC, veja temperatura, memória e estado do SSD.
Se Zigbee falha logo de cara, afaste o coordenador USB do computador com uma extensão de 50 cm a 1 m, escolha um canal Zigbee menos brigado com o Wi-Fi e adicione primeiro dispositivos alimentados pela tomada, como tomadas inteligentes e módulos com neutro. Eles ajudam a formar a malha. Sensor de bateria sozinho não salva rede fraca.
A primeira automação deve ser pequena e útil#
Depois de instalar, atualizar, nomear e fazer backup, crie uma automação simples. Nada de “modo cinema” com 14 condições no primeiro dia. Faça algo que a casa use amanhã: acender a luz do corredor quando o sensor detectar movimento depois do pôr do sol, desligar a tomada da bancada às 23h ou mandar notificação se a porta da varanda ficar aberta por mais de 10 minutos.
Essa primeira automação testa presença, horário, entidade, notificação e lógica. Se ela falhar, você depura em 5 minutos. Se você começa com uma cena gigante, não sabe se o erro está no sensor, no horário, na entidade errada, na condição ou naquele cartão visual que parecia bonito no Reddit.
Home Assistant recompensa quem monta base antes de colecionar firula. Hardware estável, rede cabeada na instalação, nomes decentes, backup e uma automação pequena valem mais do que 30 integrações instaladas no impulso.
Instalar Home Assistant do jeito certo não tem glamour. É bancada, cabo, armazenamento decente, paciência no onboarding e uma certa desconfiança com tudo que promete resolver a casa inteira em 10 minutos. Faça essa base bem feita e o resto cresce com menos susto.
Meu veredito: para 2026, Home Assistant OS em hardware dedicado continua sendo a melhor primeira escolha. Raspberry Pi atende setups menores; mini PC com SSD é o caminho que eu escolheria para uma casa que vai crescer.