Faça Backup do Home Assistant para uma Mudança Nunca Apagar a Sua Configuração

Pensa bem no que a tua casa inteligente realmente é. Não são as tomadas e sensores espalhados pelo apartamento — esses guardas-os numa caixa em vinte minutos. O que realmente construíste vive no software: as automações que apagam as luzes quando sais, o painel que reorganizaste três vezes até ficar certo, a rede Zigbee que passou uma tarde inteira a estabilizar. Tudo isso é configuração. E a configuração pode ser guardada num único ficheiro.

Se te mudares sem esse ficheiro — ou se o perderes por falha de um cartão SD — não estás só a mudar de casa. Estás a recomeçar do zero num apartamento vazio, no pior momento possível.

Para inquilinos, os riscos são especialmente claros. Todo o apelo de uma casa inteligente sem furos — o que torna o equipamento adequado a inquilinos digno do esforço — é que vem contigo. Mas “desliga e leva” só funciona se a configuração também viaja. Os backups são o que fecha essa lacuna.

Nota honesta: os passos aqui apresentados baseiam-se na documentação oficial do Home Assistant, em práticas bem testadas pela comunidade, e em detalhes publicados do ciclo de lançamento 2026.4. Descrevo fluxos que investiguei com cuidado; não vou fingir que testei pessoalmente todos os cenários de restauro em todo o hardware. Trata os rótulos específicos da interface como correctos até meados de 2026 — a formulação pode mudar ligeiramente entre versões.

O que um backup do Home Assistant contém de facto

Quando crias um backup completo no Home Assistant, o ficheiro .tar resultante agrupa tudo o que torna a tua instância tua:

• A tua configuração completa — configuration.yaml, todos os ficheiros relacionados e quaisquer componentes personalizados
• Automações, scripts e cenas — toda a lógica que escreveste ou geraste
• Dados dos add-ons — os repositórios de dados internos usados por add-ons como Zigbee2MQTT, Matter Server ou ESPHome
• Integrações instaladas e as suas definições — para que as tuas contas cloud e chaves de API venham contigo
• Painéis — vistas do Lovelace, layouts de cartões, a organização em que passaste um fim de semana
• Multimédia guardada na instância — opcional; podes excluir para manter o tamanho do ficheiro manejável

Restaura um backup completo em hardware novo e o Home Assistant reaparece exactamente como estava: os mesmos nomes de divisões, as mesmas automações, o mesmo login. As únicas coisas que normalmente precisam de atenção são os dispositivos de rádio físicos — sobretudo o emparelhamento do teu coordenador Zigbee — o que é explicado abaixo.

Um detalhe importante para 2026: desde o Home Assistant 2026.4, todos os backups são encriptados com derivação de chave Argon2id e encriptação XChaCha20-Poly1305. É uma melhoria significativa — o ficheiro guardado no teu armazenamento cloud está protegido criptograficamente mesmo que o bucket não esteja bem bloqueado. A contrapartida é que a tua frase-passe de encriptação (a chave do teu kit de emergência de backup) é agora inegociável. Não consegues restaurar sem ela, por isso trata-a como a senha do teu banco: guarda-a num gestor de palavras-passe, não num post-it.

Ainda não tens o Home Assistant? O guia de instalação explica a primeira configuração, e o seletor de hub ajuda-te a escolher o hardware certo antes de começar.

Passo 1: cria um backup agora mesmo

Vai a Definições → Sistema → Backups e clica em Criar backup. Escolhe Backup completo. O Home Assistant vai passar um minuto a comprimir tudo num ficheiro .tar com timestamp e a adicioná-lo à lista de backups.

É isso. Capturaste a tua casa inteligente num único ficheiro.

Faz isso antes de qualquer coisa importante: antes de uma actualização, antes de adicionar uma nova integração, antes de começares a fazer as malas. Um backup feito vinte minutos antes de algo correr mal é infinitamente melhor do que aquele que planeavas fazer na semana seguinte.

Passo 2: agenda backups automáticos para nunca mais teres de te lembrar

Um backup feito em Março não te consola muito quando te estás a mudar em Julho. Volta a Definições → Sistema → Backups e abre Backups automáticos. O assistente de configuração inicial do Home Assistant (a partir de 2025.1) pede mesmo aos novos utilizadores que configurem isso imediatamente — os valores padrão recomendados criam um backup nocturno e mantêm três cópias rotativas.

Se estiveres a ajustar uma instalação existente, as definições são:

• Agendamento: semanal chega para uma configuração estável; diário se estiveres activamente a construir ou a ajustar automações
• Retenção: três a cinco cópias dão-te uma janela para apanhar uma alteração má sem acumular armazenamento
• Base de dados do Recorder: este é o teu histórico de sensores e estatísticas; excluí-la mantém os backups entre 50–300 MB em vez de vários gigabytes. Para a maioria dos inquilinos, o histórico é bom ter — a configuração é o que realmente importa

Não é preciso nenhum add-on para o agendamento em si. Está integrado desde 2024.8. Configura uma vez, verifica que correu uma vez, e pronto.

Passo 3: tira uma cópia para fora do dispositivo — o passo que toda a gente salta

É aqui que a estratégia de backup da maioria das pessoas tem uma falha fatal: o backup está guardado no mesmo cartão SD que supostamente deve proteger. Se esse cartão morrer — e os cartões SD em hubs Raspberry Pi falham regularmente — o backup vai com ele.

Precisas de pelo menos uma cópia noutro sítio. As opções práticas:

Add-on Google Drive Backup Procura “Google Drive Backup” (de sabeechen) na Loja de Add-ons. Uma vez configurado, envia cada backup para o teu Google Drive de forma automática. A configuração demora cerca de dez minutos. Depois corre discretamente em segundo plano e nunca mais tens de pensar nisso. Se usas o Home Assistant Cloud, o envio externo está integrado directamente nas definições de backup.

Download manual antes de uma mudança Em Definições → Sistema → Backups, abre o menu de três pontos em qualquer backup e escolhe Transferir. Isso descarrega o .tar para o teu portátil. É lento e manual, mas é a jogada de segurança certa na noite anterior a começares a fazer as malas.

NAS ou disco de rede Se já tens um NAS na tua rede doméstica, o add-on Samba ou armazenamento de rede pode enviar backups para lá automaticamente. Excelente se já tens a configuração; desnecessário se não tens.

A regra: um backup que só existe no dispositivo não é um backup. Escolhe um destino externo ao dispositivo. Confirma que está a receber ficheiros. Segue em frente.

Passo 4: faz backup do teu coordenador Zigbee em separado

Esta é a subtileza que apanha as pessoas de surpresa, porque o backup principal do HA não a cobre. Se estiveres a usar dispositivos Zigbee — o que a maioria dos inquilinos com sensores adesivos e tomadas inteligentes faz — os teus emparelhamentos de dispositivos vivem no firmware do coordenador, não no ficheiro de configuração do Home Assistant.

• Zigbee2MQTT: vai às definições do add-on e exporta um backup do coordenador. Guarda este ficheiro ao lado do teu backup do HA.
• ZHA (Zigbee Home Automation): vai a Definições → Dispositivos e Serviços → Zigbee Home Automation → Configurar → Backup para exportar.

Saltas este passo e os teus dispositivos Zigbee terão de ser emparelhados de novo do zero no novo apartamento. Com cinco sensores é aborrecido; com vinte é uma tarde inteira. Dedica os cinco minutos agora.

Os dispositivos Thread/Matter gerem o re-emparelhamento de forma mais graciosa através do ecossistema Matter, mas ainda vale a pena anotar o que tens antes de começares a desligar tudo.

Passo 5: anota o que nenhum backup captura

Cinco minutos antes do dia da mudança, faz uma nota rápida de:

• A tua frase-passe de encriptação / chave do kit de emergência (se ainda não a guardaste num gestor de palavras-passe)
• Os dongles USB ligados ao hub — etiqueta-os com fita, porque parecem todos iguais
• Qualquer IP estático ou hostname que tenhas definido para a instância do HA
• Credenciais de add-ons que foram coladas manualmente em campos de configuração (estas nem sempre sobrevivem bem a um restauro)

Guarda esta nota no teu gestor de palavras-passe ou numa nota bloqueada no telemóvel. Não é uma lista longa, mas é exactamente o que vais querer às 21h num novo apartamento rodeado de caixas.

Restauro em hardware novo: o fluxo do dia da mudança

Seja a reflashares o mesmo cartão SD, a actualizares para um Home Assistant Green, ou a substituíres um Raspberry Pi morto por um novo, o caminho de restauro é o mesmo:

1. Grava uma imagem nova do Home Assistant OS no novo dispositivo
2. No primeiro arranque, o assistente de configuração inicial pergunta se queres restaurar a partir de um backup — diz que sim
3. Carrega o teu ficheiro .tar do portátil, ou aponta-o para a localização do teu backup no Google Drive
4. Introduz a tua frase-passe de encriptação
5. O Home Assistant restaura tudo: configuração, add-ons, integrações, painéis
6. Após o reinício, reimporta o teu backup do coordenador Zigbee e deixa os dispositivos rejuntar-se

Em hardware equivalente, isto é genuinamente sem falhas. Mudar para um tipo de dispositivo diferente (por exemplo, Pi 4 para Home Assistant Green) está bem documentado e funciona sem problemas — configuração, automações e integrações transferem-se todas. As únicas coisas que podem precisar de um pequeno ajuste são add-ons com configurações de passthrough USB específicas do hardware.

Conta com uma a duas horas no total para o restauro, o re-emparelhamento Zigbee, e uma verificação rápida de que as tuas cinco automações principais estão a funcionar correctamente.

A realidade dos cartões SD

Os cartões SD e o Home Assistant têm uma relação complicada. As escritas pequenas constantes que o HA faz — registar estados de sensores, actualizar a base de dados do recorder, guardar alterações de configuração — são genuinamente duras para os cartões SD ao longo do tempo. A falha não é uma questão de se; é uma questão de quando.

A solução em que os utilizadores sérios do HA acabam por pousar: arrancar a partir de um SSD em vez de um cartão SD. É mais durável, mais rápido, e elimina o ponto único de falha mais comum. O seletor de hub pode ajudar-te a encontrar hardware que suporte arranque por SSD nativamente — o Home Assistant Green e certas configurações de Raspberry Pi suportam-no.

Mas mesmo com um SSD, os backups importam. O hardware falha, o firmware corre mal, as actualizações têm dias maus. Os backups externos ao dispositivo são a última linha que mais nada cobre.

Perguntas frequentes

Um backup completo inclui tudo o que preciso para restaurar completamente? Quase tudo. Configuração, automações, painéis, dados de add-ons, integrações — sim. Os emparelhamentos de rádio Zigbee e quaisquer credenciais que colaste directamente em campos de configuração de add-ons — esses precisam do tratamento em separado descrito acima. Para a grande maioria de uma configuração típica de inquilino, o backup completo é suficiente.

E se perder a frase-passe de encriptação? A partir de 2026.4, não há caminho de recuperação sem a frase-passe. A encriptação é intencionalmente robusta. O Home Assistant gera um kit de emergência quando configuras os backups pela primeira vez — um PDF com a chave — e pede-te que o descarregues. Se o perdeste e ainda tens acesso à instância em execução, vai a Definições → Sistema → Backups → Definições de backup e regenera a chave, depois descarrega um kit de emergência novo. Faz isso agora, não depois de algo correr mal.

Qual é o tamanho típico de um backup? Sem a base de dados do recorder, um backup completo para uma configuração modesta de inquilino tende a ter entre 50–300 MB. Incluindo a base de dados pode chegar a vários gigabytes. Para uma mudança, um backup sem a base de dados é normalmente a escolha certa — precisas da configuração, não do histórico dos sensores.

Posso restaurar em hardware diferente daquele em que fiz o backup? Sim, com ressalvas menores. Os backups do Home Assistant OS são concebidos para ser portáteis entre hardware suportado. Restaurar de um Raspberry Pi 4 para um Home Assistant Green é um caminho documentado e bem testado. Alguma configuração de passthrough USB pode precisar de ajuste, mas tudo o resto — configuração, automações, integrações, painéis — chega intacto.

Conclusão

A tua casa inteligente é mesmo só meses de configuração. Os dispositivos são a parte fácil — viajam contigo numa caixa de cartão. As automações, o painel, as integrações: essas vivem num ficheiro, e esse ficheiro precisa de ser protegido.

As quatro coisas que tornam a tua configuração portátil: backups automáticos activados em Definições → Sistema → Backups; cópias fora do dispositivo via o add-on do Google Drive ou um download manual antes da mudança; um backup do coordenador Zigbee exportado em separado; e a tua frase-passe de encriptação guardada num sítio onde a vás encontrar de facto.

Faz estas quatro coisas e nenhum cartão SD morto, nenhuma actualização falhada e nenhum dia de mudança te vai custar a casa inteligente que construíste. Se ainda estás a planear o que construir, o configurador sem furos é um bom ponto de partida — e o seletor de hub ajuda-te a escolher hardware que não te vai decepcionar.