Como evitar a perda da configuração do Home Assistant durante as atualizações

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Evite perder a configuração do Home Assistant usando o sistema de cópias de segurança integrado como via principal de recuperação e tratando o ambiente de execução como substituível. A versão do Home Assistant, a imagem do contentor ou o anfitrião podem mudar; a cópia de segurança, a chave de encriptação, a definição de execução e quaisquer dependências externas têm de continuar disponíveis quando a máquina original já não estiver acessível.

As cópias de segurança modernas do Home Assistant funcionam com todos os tipos de instalação, incluindo a instalação em contentor. Mantenha uma cópia manual separada da árvore de configuração quando isso for útil, mas não baseie todo o plano de atualização na cópia manual de ficheiros, ignorando o fluxo de trabalho suportado de cópia de segurança e restauro.

Comece com uma cópia de segurança integrada, não com uma pasta YAML copiada manualmente

Não reduza a «configuração» ao configuration.yaml. O sistema de cópias de segurança suportado pelo Home Assistant inclui o estado da aplicação necessário para a recuperação, incluindo a configuração e os dados da base de dados, enquanto os fluxos de trabalho mais recentes também permitem automatização, retenção e localizações fora do anfitrião.

A reformulação das cópias de segurança, introduzida em 2025, acrescentou cópias de segurança encriptadas automáticas, controlos de retenção e localizações externas para cópias de segurança. Assim, a cópia de segurança integrada é o primeiro recurso de recuperação a verificar antes de uma atualização, em vez de depender de uma cópia manual incompleta.

Registe também a raiz da configuração, a escolha da base de dados, as referências a segredos, os componentes personalizados, o material SSL e quaisquer ficheiros externos ou serviços de que uma integração necessite. Uma cópia de segurança pode restaurar o estado do Home Assistant sem documentar automaticamente todos os dispositivos USB, caminhos de rede, anfitriões de bases de dados ou parâmetros do contentor associados.

Mantenha explícitos a persistência do contentor e os parâmetros de execução

No Docker, confirme a montagem de ligação ou o volume que contém /config e preserve a definição do Compose ou do comando de execução que recria o modo de rede, os mapeamentos de dispositivos, o fuso horário, os privilégios e os serviços externos. O sistema de ficheiros do próprio contentor deve poder ser descartado.

Uma discussão sobre cópias de segurança do Home Assistant em Docker mostra claramente o modo de falha: quando os utilizadores mapeiam apenas um ficheiro, em vez do diretório de configuração completo, dados importantes podem ficar presos dentro do contentor e desaparecer quando esse ambiente de execução é substituído.

Verifique a montagem do anfitrião antes da atualização e mantenha a definição de execução junto da cópia de segurança. A recuperação é muito mais rápida quando já se conhecem tanto o estado da aplicação como as instruções necessárias para disponibilizar rádios, portas, redes e armazenamento.

Guarde pelo menos uma cópia de segurança encriptada fora do anfitrião

Uma cópia de segurança no mesmo SSD protege contra alguns erros de configuração, mas não contra a perda do anfitrião, corrupção do sistema de ficheiros, roubo ou avaria do dispositivo de armazenamento. Guarde pelo menos uma cópia de recuperação num NAS, noutro computador ou numa localização remota de cópias de segurança cujo acesso não dependa do anfitrião do Home Assistant avariado.

Guarde também a chave de encriptação da cópia de segurança ou o kit de emergência fora do Home Assistant. O Home Assistant 2026.4 passou a usar, nas novas cópias de segurança encriptadas, o formato SecureTar v3 auditado, com encriptação moderna mais robusta, o que reforça a segurança das cópias de segurança, mas torna a gestão da chave uma parte explícita da capacidade de recuperação.

Mantenha versões das cópias de segurança em vez de substituir sempre o mesmo ficheiro. Uma atualização pode revelar um problema dias mais tarde, e o ponto de recuperação mais recente pode já conter o estado migrado ou danificado de que está a tentar sair.

A cópia de segurança continua a não substituir a definição do ambiente de execução

A configuração, por si só, pode não restaurar os rádios USB, a rede do anfitrião, o fuso horário, a passagem de dispositivos, os serviços de base de dados, o MQTT ou as relações com o proxy inverso. Preserve o ficheiro Compose, a política de versões da imagem, as variáveis de ambiente, os caminhos do anfitrião, os mapeamentos de dispositivos e as dependências de serviços necessários para recriar o ambiente de execução.

Não coloque segredos em texto simples num repositório público apenas para controlar as versões do ficheiro Compose. Guarde os valores secretos num local protegido e documente apenas onde o processo de recuperação os vai buscar.

O guia de implementação do Home Assistant no ZimaBoard do ZimaSpace é um contexto útil para separar a plataforma do servidor doméstico do estado da aplicação que tem de sobreviver a futuras alterações de implementação.

Faça um teste de restauro antes de uma emergência motivada pela atualização

A existência do arquivo não comprova que a cópia de segurança funciona. Restaure-a num destino isolado ou num contentor temporário, volte a ligar dispositivos e caminhos representativos, sempre que possível, e confirme que o sistema regressa com os utilizadores, painéis, integrações, automatizações, auxiliares e o estado esperado.

Utilize o teste para detetar palavras-passe em falta, caminhos desatualizados no anfitrião, mapeamentos de dispositivos não documentados e bases de dados demasiado grandes enquanto o sistema de produção ainda funciona. Registe os passos de restauro depois do teste bem-sucedido; confiar na memória não é um plano de recuperação.

Imediatamente antes de atualizar, crie um novo ponto de recuperação, registe a versão atual do Home Assistant e a imagem do contentor e verifique as alterações da versão que afetam as suas integrações. Mantenha o ambiente de execução anterior disponível até a instância atualizada passar um período normal de utilização e um reinício.

Utilize uma verificação de segurança da atualização em quatro partes

Recurso de recuperação O que protege Falha se estiver em falta
Cópia de segurança integrada Configuração do Home Assistant e estado recuperável da aplicação Não existe um ponto de restauro suportado
Chave de encriptação / kit de emergência Acesso às cópias de segurança protegidas Existe uma cópia de segurança, mas não é possível abri-la
Definição do ambiente de execução Pontos de montagem, dispositivos, rede, ambiente Estado correto, mas acesso ao serviço indisponível
Cópia externa ao anfitrião + teste de restauro Falha do anfitrião e validade do procedimento A recuperação desaparece com a produção ou falha quando é necessária

Atualize apenas quando os quatro elementos estiverem assegurados. Uma cópia manual da árvore de configuração pode servir como camada adicional, mas o plano de recuperação principal deve ser uma cópia de segurança suportada que consiga desencriptar e restaurar, juntamente com um ambiente de execução documentado.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.