Tropic Host

Home Assistant: o que é, recursos e instalação em um servidor

6 min de leitura
Tropic
Home Assistant: o que é, recursos e instalação em um servidor

Home Assistant: uma central de controle unificada para a casa inteligente

A lâmpada inteligente está configurada em um aplicativo, o robô aspirador em um segundo, o ar-condicionado em um terceiro, enquanto o sensor de vazamento envia notificações por um quarto. No fim, a “casa inteligente” exige mais ações manuais do que um interruptor comum.

O Home Assistant reúne dispositivos compatíveis em um único painel e os conecta por meio de automações. Vamos analisar seus recursos, requisitos e a instalação com Docker Compose.

Home Assistant em sete etapas

  1. Verificar os dispositivos no catálogo de integrações do Home Assistant.
  2. Escolher o local de instalação: hub pronto, mini PC, Raspberry Pi, NAS, máquina virtual ou servidor Linux.
  3. Instalar o Home Assistant OS ou o Home Assistant Container.
  4. Adicionar os dispositivos e serviços encontrados.
  5. Distribuí-los por cômodos e configurar o painel.
  6. Criar uma automação realmente útil.
  7. Configurar backups e acesso remoto seguro.

É melhor começar não com dezenas de cenários, mas com um único problema que realmente incomoda. Quando a primeira automação estiver funcionando de forma estável, o sistema poderá ser ampliado.

O que é o Home Assistant

O Home Assistant é uma plataforma gratuita e de código aberto para controlar uma casa inteligente. Ele funciona como uma central: conecta-se a dispositivos e serviços de diferentes fabricantes e permite gerenciá-los por uma interface web ou aplicativo móvel.

O catálogo do projeto oferece mais de 1.500 integrações: iluminação, equipamentos de climatização, câmeras, robôs aspiradores, medidores de energia, MQTT, Zigbee, Z-Wave, Matter, Apple HomeKit e serviços em nuvem.

A principal diferença em relação ao aplicativo de uma marca específica é que o cenário não fica limitado a um único ecossistema. Um sensor de um fabricante pode acender a lâmpada de outro, alterar a temperatura em um termostato de terceiros e enviar uma notificação para o celular.

Por que o Home Assistant é mais útil do que vários aplicativos

Se o sistema apenas transfere o interruptor para o smartphone, a casa não fica mais inteligente. O valor do Home Assistant começa quando uma ação rotineira é executada automaticamente.

As automações são formadas por um gatilho, uma condição opcional e uma ação. Por exemplo: “alguém chegou em casa” é o gatilho, “o sol já se pôs” é a condição e “acender as luzes da sala” é a ação.

Os dispositivos aparecem em um painel comum para celular, computador ou tablet fixado na parede. É possível distribuí-los por cômodos e criar telas separadas para familiares e visitantes.

Com uma integração local, os comandos e os dados permanecem na rede doméstica, e os cenários podem funcionar sem internet. Porém, se um dispositivo oferece apenas uma API na nuvem, o Home Assistant também dependerá do serviço do fabricante.

Também estão disponíveis notificações móveis, detecção de presença, o assistente de voz Assist e um painel de energia para acompanhar a rede elétrica, painéis solares, baterias, gás, água e aparelhos individuais.

Cenários úteis para o Home Assistant

Iluminação sem usar o interruptor o tempo todo

Um sensor de movimento acende as luzes somente depois do pôr do sol. À noite, utiliza-se um brilho reduzido e, após alguns minutos sem movimento, as lâmpadas são desligadas.

Proteção contra vazamentos

Um sensor detecta água, o sistema fecha uma válvula elétrica compatível, desliga a bomba e envia uma notificação. A ação importante é executada imediatamente, sem esperar que o proprietário veja a mensagem.

Climatização com base na presença

Quando a última pessoa sai, o aquecimento ou o ar-condicionado passa para o modo de economia de energia. Uma janela aberta também pode desligar temporariamente a climatização de um cômodo específico.

Notificação de término da lavagem

Uma tomada inteligente mede o consumo da máquina de lavar. Quando a potência cai abaixo de um nível definido após o ciclo, o Home Assistant avisa que está na hora de retirar as roupas.

Identificação de consumo desnecessário de energia

O histórico de consumo ajuda a perceber cargas que ficam ligadas continuamente e a entender quais aparelhos são mais econômicos quando usados em outro horário.

É necessário saber programar

Não é necessário programar para montar uma casa inteligente básica. Integrações, cômodos, painéis e a maioria das automações são configurados pela interface gráfica.

YAML, modelos e integrações próprias são necessários em casos complexos. Não é preciso começar por eles: guias antigos que exigem a edição manual de quase todos os parâmetros já não representam o caminho normal para iniciantes.

Onde é melhor instalar o Home Assistant

A documentação atual apresenta duas opções principais: Home Assistant Operating System e Home Assistant Container.

OpçãoPara quem é indicadaO que é importante saber
Home Assistant GreenPara quem precisa de um hub prontoO sistema já vem instalado
Raspberry Pi ou mini PC com Home Assistant OSPara a maioria dos usuários domésticosAtualizações, backups e aplicativos fáceis de gerenciar
Máquina virtual em um NAS ou servidor domésticoPara quem já tem um host sempre ligadoÉ possível alocar recursos e repassar dispositivos USB
Home Assistant ContainerPara usuários de DockerNão há loja de aplicativos integrada, e as atualizações são manuais
VPSPara testes e locais remotosNão há acesso direto aos dispositivos sem fio da residência

O Home Assistant OS é a opção recomendada para a maioria dos usuários. O Container é conveniente quando outros serviços já estão em execução em um servidor Linux, mas os aplicativos e alguns componentes para Thread ou Z-Wave precisam ser administrados separadamente.

Quantos recursos são necessários

O mínimo oficial para uma máquina virtual é 2 vCPU e 2 GB de RAM. Referências práticas:

CenárioCPURAMArmazenamento
Sistema de teste ou pequeno2 vCPU2 GBSSD de 32 GB
Instalação doméstica com reserva para serviços adicionais2–4 vCPU4 GBSSD de 32–64 GB
Câmeras, voz local e histórico extenso4+ vCPU8+ GBSSD a partir de 64 GB

Câmeras, tempo de retenção do histórico, modelos de voz e contêineres adicionais são os elementos que mais aumentam a carga. Para uma instalação permanente, é melhor usar um SSD.

Como instalar o Home Assistant com Docker Compose

Este método é adequado para um servidor Linux com Docker Engine e Docker Compose instalados. Crie um diretório:

mkdir -p ~/homeassistant/config
cd ~/homeassistant

Crie o arquivo compose.yaml:

services:
  homeassistant:
    container_name: homeassistant
    image: ghcr.io/home-assistant/home-assistant:stable
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    environment:
      TZ: Etc/UTC
    restart: unless-stopped
    stop_grace_period: 60s
    privileged: true
    network_mode: host

A linha com /run/dbus é necessária para Bluetooth e pode ser removida quando ele não for utilizado. Substitua o fuso horário Etc/UTC pelo seu. Inicie o contêiner:

docker compose up -d

A interface será aberta em http://IP_DO_SERVIDOR:8123. Em um servidor doméstico, use-a dentro da rede local. Em um VPS, feche antecipadamente a porta 8123 no firewall externo.

Para o primeiro acesso a um servidor remoto, é possível criar um túnel SSH:

ssh -L 8123:127.0.0.1:8123 user@IP_DO_SERVIDOR

Abra http://localhost:8123, crie uma conta de administrador e adicione as primeiras integrações.

É possível usar o Home Assistant em um VPS

O Home Assistant Container funciona em um VPS Linux. Isso é adequado para conhecer a interface, usar integrações em nuvem e conectar locais remotos por VPN ou MQTT.

No entanto, um VPS fica fora da residência. Normalmente, ele não consegue encontrar dispositivos locais pela descoberta de rede nem usar diretamente o adaptador USB Zigbee, Z-Wave ou Thread instalado em casa. Os sensores Bluetooth também ficam fora de alcance.

Por isso, é mais sensato manter o controlador principal em casa e usar o VPS como uma camada externa: gateway VPN, ponto de acesso seguro, servidor de monitoramento ou host para serviços relacionados.

Para um sistema de teste sem protocolos de rádio locais, 2 vCPU, 2 GB de RAM e um SSD são suficientes. Na tropic.host, é possível começar com uma configuração Linux pequena e aumentar os recursos caso sejam adicionados MQTT, Node-RED, um banco de dados ou outros contêineres ao Home Assistant. Ainda assim, Zigbee, Thread, Z-Wave e Bluetooth devem permanecer no nó doméstico.

Como configurar acesso seguro e backups

Não exponha diretamente a porta 8123. Para o controle remoto, use o Home Assistant Cloud, uma VPN ou um proxy reverso com HTTPS. Ative a autenticação multifator e conceda permissões de administrador apenas aos usuários que realmente precisam delas.

O Home Assistant oferece backups automáticos criptografados. Mantenha uma cópia fora do sistema e armazene separadamente o emergency kit com a chave de criptografia.

Erros comuns

ErroMelhor abordagem
Comprar um dispositivo antes de verificar a integraçãoAnalisar os modelos e recursos compatíveis
Criar dezenas de automações imediatamenteComeçar com um cenário simples
Remover completamente os interruptores físicosManter o controle manual para funções críticas
Instalar um coordenador Zigbee em um VPSColocá-lo dentro da residência
Manter o backup junto do sistemaCriar uma cópia em outro dispositivo ou fora de casa

Conclusão

O Home Assistant transforma dispositivos separados em um sistema comum: um único painel, um histórico unificado e automações entre diferentes marcas. É possível começar sem programar: verificar a compatibilidade, instalar o Home Assistant OS ou Container e criar um cenário útil.

É melhor manter o servidor principal dentro de casa, especialmente ao usar Zigbee, Thread, Z-Wave ou Bluetooth. Um VPS é útil para testes, integrações em nuvem, VPN, monitoramento e serviços relacionados, mas não substitui um gateway de rádio local.

FAQ

O Home Assistant é gratuito?

Sim. O hardware, serviços em nuvem de terceiros e a assinatura opcional do Home Assistant Cloud podem ser pagos.

O sistema funciona sem internet?

As integrações e automações locais continuarão funcionando dentro da rede doméstica. Dispositivos que dependem exclusivamente da nuvem ficarão indisponíveis sem internet.

É necessário ter um Raspberry Pi?

Não. Também é possível usar o Home Assistant Green, um mini PC, um computador antigo, um NAS, uma máquina virtual ou um servidor Linux.

Qual é melhor: Home Assistant OS ou Container?

O Home Assistant OS é mais conveniente para a maioria dos usuários. O Container é indicado para quem já utiliza Docker e está disposto a administrar serviços adicionais por conta própria.

É possível conectar dispositivos de fabricantes diferentes?

Sim, desde que existam integrações compatíveis. Antes da compra, verifique não apenas a marca, mas também o modelo específico e as funções suportadas.