Home Assistant: Backup, Atualização e Manutenção Sem Pânico

Home Assistant quebrando raramente começa com explosão. Começa com coisinha: um sensor indisponível, uma atualização pendente, um backup velho, um log repetindo aviso, uma automação que falha só às vezes. Você ignora porque a casa ainda funciona. Depois vem a queda de energia, o SSD cansado, o add-on que não sobe ou a versão nova que mudou comportamento. Aí o hobby vira plantão. Manutenção é a parte menos sedutora da automação residencial. Também é a que salva o fim de semana.

Este último artigo não inventa projeto. Ele fecha a série com rotina de sobrevivência: backup, atualização, diagnóstico, logs, dispositivos indisponíveis e troca de hardware. Home Assistant é confiável quando tratado como infraestrutura. Não precisa virar administrador paranoico. Precisa ter três hábitos: backup fora da máquina, atualização com critério e painel de manutenção que mostra problema antes de virar incêndio.

Backup que fica no mesmo disco é quase pedido de desculpa#

Backup local no próprio Home Assistant ajuda contra erro de configuração. Se você instalou um add-on ruim, apagou entidade errada ou quebrou uma automação, restaura. Mas se o SSD morre, se o hardware some, se a máquina não liga, o backup no mesmo disco foi embora junto. Backup de verdade precisa existir fora do servidor: armazenamento de rede, nuvem, computador, NAS, pendrive guardado com rotina. O destino importa menos que a disciplina.

A frequência depende do quanto a casa muda. No começo, faça backup antes de qualquer bloco grande de alteração: instalar add-on, atualizar versão principal, migrar Zigbee, mexer em banco de dados, criar várias automações. Depois, automatize. Casa com automações diárias merece backup diário ou, no mínimo, algumas vezes por semana. E faça teste de restauração em algum momento. Backup não testado é promessa. Promessa não acende luz.

Atualização não é corrida#

Home Assistant tem atualizações frequentes. Isso é bom: correções chegam rápido, integrações melhoram, recursos aparecem. Só que casa inteligente não é app de rede social. Atualizar no minuto em que sai versão grande pode ser desnecessário se tudo está funcionando. Minha regra: correções menores podem entrar rápido depois de backup; versões mensais grandes merecem leitura de notas e um horário em que você possa observar. Atualizar antes de dormir é pedir para conhecer o log às 23h40.

Crie janela de atualização. Sábado de manhã, por exemplo. Faça backup, atualize, reinicie, teste automações críticas, veja dispositivos indisponíveis. Se algo quebrou, você tem tempo e cabeça. Se atualizou às pressas antes de viajar, qualquer falha vira drama remoto. Home Assistant dá liberdade, mas não impede decisão ruim. A maturidade é saber que nem toda atualização precisa entrar hoje.

Logs não são castigo; são pista#

O log do Home Assistant assusta porque mistura aviso útil, mensagem técnica e barulho de integração. Não precisa entender tudo. Procure padrões: erro repetido a cada minuto, integração falhando autenticação, dispositivo indisponível, banco de dados reclamando, add-on reiniciando. Um erro isolado pode ser ruído. Erro repetido é goteira. Se o log cresce sem parar, algo está consumindo recurso e atenção. Ignorar log por meses é como ignorar cheiro de queimado porque a luz ainda está acesa.

Use o log junto com o histórico de automações. Se uma regra não executou, veja trace. Se um dispositivo sumiu, veja integração. Se várias coisas caíram ao mesmo tempo, olhe rede, energia e servidor. Diagnóstico bom começa amplo e afunila. Diagnóstico ruim troca dispositivo no escuro. Home Assistant oferece pistas; você só precisa não sair clicando em tudo antes de ler.

Dispositivo indisponível não é sempre culpa do Home Assistant#

Quando uma entidade aparece unavailable, o culpado pode ser dispositivo, rádio, roteador, integração, bateria, alcance, canal, firmware ou energia. Sensores Zigbee a bateria somem quando a bateria cai ou quando a malha está fraca. Dispositivos Wi-Fi somem quando o roteador muda canal, a senha troca, o DHCP falha ou o fabricante depende de cloud. Matter sobre Thread pode sofrer com border router e IPv6. Culpar Home Assistant de primeira é confortável. Nem sempre é justo.

A ordem de checagem deve ser simples. O dispositivo tem energia ou bateria? Está ao alcance? Outros dispositivos do mesmo protocolo funcionam? A integração está carregada? O roteador mostra o aparelho online? Houve atualização recente? O log mostra autenticação ou timeout? Com essas perguntas, você evita resetar tudo sem necessidade. Reset de fábrica é último recurso, não reflexo.

Banco de dados cresce; histórico precisa de limite#

Home Assistant guarda histórico e estatísticas. Isso é útil para energia, temperatura, presença e diagnóstico. Também ocupa espaço. Sensores que atualizam a cada segundo, entidades barulhentas e integrações mal configuradas podem inflar banco de dados. Se o armazenamento é pequeno, isso vira lentidão ou falha. Não grave tudo para sempre. Defina o que merece histórico longo e o que pode ser filtrado. Nem todo sensor precisa virar memória eterna da casa.

Energia e clima tendem a merecer histórico. Estado de debug, RSSI a cada poucos segundos e sensores irrelevantes não. O painel de manutenção deve mostrar uso de disco. Se o armazenamento passa de 80%, pare de adicionar coisa e investigue. SSD cheio deixa sistema estranho antes de cair de vez. Casa inteligente não deveria depender de “acho que ainda tem espaço”.

Add-ons são úteis, mas cada um vira responsabilidade#

Add-on é um dos motivos para preferir Home Assistant OS. Mosquitto, Zigbee2MQTT, backups, arquivos, Studio Code Server, Matter Server, ESPHome: tudo fica mais acessível. Só que cada add-on é um serviço a mais para atualizar, configurar e observar. Instalar add-on por curiosidade é fácil. Remover a bagunça depois é chato. Antes de instalar, pergunte: isso resolve problema real agora? Se a resposta for “talvez um dia”, espere esse dia chegar.

Também evite sobrepor funções. Dois sistemas tentando controlar o mesmo rádio, dois bancos de dados, duas integrações para o mesmo dispositivo, dois caminhos de cloud para o mesmo aparelho. Duplicidade cria estado fantasma. Você desliga no painel, liga no app, o Home Assistant atualiza depois e a automação dispara fora de hora. Um caminho claro é melhor que três atalhos espertos.

Rotina semanal de 10 minutos#

Uma vez por semana, abra o dashboard de manutenção. Veja backups recentes, atualizações pendentes, dispositivos indisponíveis, baterias baixas, uso de armazenamento e erros repetidos. Depois teste uma automação crítica, como Boa noite ou alerta de porta. Cinco a dez minutos. Só isso. Essa rotina pega problema pequeno antes de virar reconstrução. A casa que parece automática por fora precisa de cuidado por dentro.

Uma vez por mês, leia notas da versão principal antes de atualizar. Exporte backup para fora. Reinicie o servidor em horário seguro. Verifique se o app Companion ainda recebe notificação. Troque bateria de sensores críticos antes de zerar. Revise automações que ninguém usa. Apague teste antigo. Manutenção boa é faxina: ninguém gosta de fazer, todo mundo percebe quando nunca foi feita.

Migração de hardware sem pânico#

Um dia você vai trocar de hardware. Pode ser SSD maior, mini PC novo, Home Assistant Green para mini PC ou Raspberry para x86. Com backup recente, migração costuma ser tranquila: instala base nova, restaura backup, confere IP, dongles e integrações. Sem backup, vira arqueologia. Dongles de rádio exigem cuidado extra. Zigbee e Z-Wave guardam informações no coordenador/controlador e na integração; migrar sem entender pode obrigar pareamento de tudo. Leia antes de mover rádio.

Mantenha lista de dongles, portas USB, extensores e protocolos. Parece exagero quando há um dongle só. Depois aparecem Zigbee, Z-Wave, Bluetooth proxy, Thread e armazenamento externo. Uma etiqueta no cabo evita meia hora de dúvida. Infraestrutura doméstica também merece identificação. Não precisa rack profissional. Precisa não parecer ninho de cobra.

Quando chamar ajuda#

Chame ajuda quando envolver elétrica, carga alta, quadro de distribuição, automação de segurança crítica, fechadura externa ou falha persistente que você não consegue isolar. Home Assistant dá poder demais para improviso parecer solução. Não é. Integrador bom, eletricista bom e documentação boa custam menos que refazer instalação depois de susto. Saber parar é parte da competência.

Também peça ajuda quando a casa já depende do sistema e você não tem tempo para aprender durante a falha. Uma coisa é quebrar automação de luz decorativa. Outra é perder controle de climatização, energia, portão, alarme ou rotina de alguém com mobilidade reduzida. Quanto mais a casa depende do Home Assistant, mais profissional deve ser a manutenção. Hobby que vira infraestrutura precisa amadurecer.

O fechamento honesto da série#

Depois de 10 dias, o iniciante já tem mapa: o que é Home Assistant, onde rodar, como instalar, como organizar, que protocolo escolher, como automatizar, como montar dashboard, como usar voz, como medir energia e como manter tudo vivo. Ainda há muito para aprender: templates, YAML, ESPHome, MQTT avançado, segurança remota, banco de dados, presença refinada. Mas a base está posta. E base boa é metade da casa.

O Home Assistant recompensa quem vai devagar e pune quem compra antes de pensar. Não por maldade. Porque ele mostra a casa como sistema, com dependências, estados e falhas possíveis. Quem aceita isso ganha controle local, automações finas e liberdade de marca. Quem ignora vira administrador de caos. A escolha aparece todo dia, no momento mais simples: a luz acende, sem drama, porque alguém fez o trabalho chato direito.

A série termina aqui porque agora há base para crescer sem chute. O próximo passo editorial natural é sair do iniciante e abrir módulos avançados: ESPHome, MQTT, presença, segurança remota e templates.