Library
All guides
Follow the beginner path. Additional topics are in further learning, at the end.
The core guides of the beginner path are available in English. Guides marked PT are still in Brazilian Portuguese and are being translated — browser translation works well on those pages.
Start here, in this order
- Start your smart home The full path from nothing to your first automated light, without programming: what to buy, in which order, how long it takes and the usual mistakes.
- What is a smart home? What a smart home is, how Home Assistant, Alexa, Google Home, Apple Home, SmartThings and Tuya compare, the local-versus-cloud difference and where to start without wasting money.
- What is Home Assistant? Discover automations, voice, apps, brands, ESPHome and cameras in a connected home with Home Assistant — what the hub does and why it is the centre of this site.
- Home Assistant OS: choose your installation Green, Raspberry Pi 5 or mini PC: which to choose, what to prepare, what happens on first access, what to do when the address does not open, and the next steps.
- Instalar HAOS no Raspberry Pi 5 com SSD NVMein Portuguese Peças, case, HAT, preparo do boot e gravação do HAOS no NVMe pelo Mac ou PC.
- Instalar HAOS no mini-PC x86-64, passo a passoin Portuguese Pendrive, BIOS UEFI e gravação do HAOS no SSD interno de um mini-PC Intel ou AMD.
- Instalar o Home Assistant Green, passo a passoin Portuguese Da tomada ao primeiro sensor Zigbee: Green, primeiro acesso, ZBT-2, ZHA e backup.
- Zigbee: the basics for lights and sensors How Zigbee connects lights and sensors without Wi-Fi: coordinator, routers, battery devices, channels, range and what to check before buying.
- Thread e Matter, sem confusãoin Portuguese Thread é a rede, Matter é o padrão: papéis, o que conferir na embalagem, o que o Home Assistant precisa para cada caso e quando faz sentido na sua casa.
- ZBT-2 and ZHA: connect your first device ZBT-1 and ZBT-2 compared, how to connect the adapter to the hub, set up ZHA through the screens and pair your first Zigbee bulb or sensor.
- Sua primeira automação pelas telasin Portuguese Crie no editor visual do Home Assistant uma automação que acende a luz ao pôr do sol, teste cada etapa e aprenda a diagnosticar quando não funciona.
- Integrações, Apps, HACS e câmerasin Portuguese Integrações, Apps e HACS explicados: quais valem no começo, como reconhecer uma integração local ou de nuvem e como colocar a primeira câmera no painel.
Further learning — for later
- Aprofundamento: para depois do básicoin Portuguese Roteiro para a segunda fase: tipos de instalação, Zigbee2MQTT, câmeras com Scrypted e Frigate, ESPHome, MQTT, rede, acesso remoto, IA e manutenção.
- Zigbee2MQTT ou ZHA: quando considerar a mudançain Portuguese ZHA e Zigbee2MQTT comparados ponto a ponto, os sinais de que vale migrar, como conferir seu modelo no catálogo e como planejar a troca sem perder a rede.
- Zigbee2MQTT desconectando: como encontrar a causain Portuguese Diferencie falhas de MQTT, coordenador e dispositivos Zigbee. Um roteiro de diagnóstico antes de resetar ou parear sua rede novamente.
- Minha instalação: Home Assistant, luzes e controlesin Portuguese Fotos e equipamentos da minha casa: mini-PC com HAOS, WLED, Philips Hue, Alexa, Apple HomeKit e uma tela ESP32-S3 com ESPHome.
- Escolha sua centralin Portuguese Home Assistant Green, Raspberry Pi 5 ou mini-PC: desempenho, consumo, consulta de preços e para quem cada central faz sentido, com fotos e tabela.
- Sensors with ESPHome and ESP32 Build temperature, presence and energy sensors with ESP32 and ESPHome, without coding in C: components, your first project and Home Assistant integration.
- ESPHome examples Complete, ready-to-copy ESPHome configurations — a Bluetooth Proxy, an IR receiver, Thread devices and displays — for your Home Assistant.
- MQTT sem complicaçãoin Portuguese O que é MQTT, como funcionam broker, tópicos e mensagens retidas, quando o Home Assistant precisa dele e como instalar o Mosquitto no HAOS.
- Home Assistant no app Casain Portuguese Exponha luzes, sensores e câmeras do Home Assistant ao app Casa da Apple e à Siri com a integração HomeKit Bridge, passo a passo pelas telas.
- Conheça o Home Assistant Cloudin Portuguese O que o Home Assistant Cloud (Nabu Casa) oferece: acesso remoto seguro, Alexa e Google Assistant sem abrir portas, preço e quando vale assinar.
- Conecte suas câmerasin Portuguese Leve as câmeras ao painel do Home Assistant, ao HomeKit Secure Video e ao app Casa com Scrypted e Frigate: requisitos, gravação e opções locais.
- Câmeras com inteligência artificialin Portuguese Detecção de pessoas, veículos e animais com Frigate e descrições por modelos de visão: o que cada opção exige de hardware, custo e privacidade.
- Converse com sua casain Portuguese Claude e Home Assistant com MCP: conector remoto, autenticação OAuth, diferença entre cliente e servidor e roteiro para verificar a conexão.
- Conheça o OpenClawin Portuguese O que é o OpenClaw, como o agente autônomo age sobre a casa e os riscos de injeção de prompt, skills maliciosas e segredos sem criptografia.
- Prepare a rede da casain Portuguese Prepare a rede da casa para automação: canais de 2,4 GHz sem brigar com o Zigbee, IP reservado, mDNS, VLAN para IoT e diagnóstico de quedas.
- Seu servidor com CasaOS ou umbrelOSin Portuguese CasaOS e umbrelOS num Raspberry Pi ou mini-PC: arquivos, mídia e aplicativos fora do Home Assistant, com instalação, diferenças e cuidados.
- Comandos do Home Assistant OSin Portuguese Referência de comandos do Home Assistant OS para manutenção e diagnóstico: ha core, supervisor, backups, rede, logs, banco de dados e recuperação.
