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

Evite perder a configuração do Home Assistant, fazendo do sistema de cópias de segurança integrado o principal caminho 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 do ambiente de execução e quaisquer dependências externas têm de continuar disponíveis quando a máquina original desaparecer.

As cópias de segurança modernas do Home Assistant funcionam em todos os tipos de instalação, incluindo 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 captura o estado da aplicação necessário para a recuperação, incluindo o conteúdo da configuração e da base de dados, enquanto os fluxos de trabalho de cópia de segurança mais recentes também suportam automatização, retenção e localizações externas ao anfitrião.

A reformulação das cópias de segurança introduzida em 2025 acrescentou cópias de segurança automáticas encriptadas, controlos de retenção e localizações de cópia de segurança externas. Isto torna 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 ainda 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 ou serviços externos necessários a uma integração. 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ícitas a persistência do Contentor e as definições do ambiente de execução

Para Docker, confirme a montagem vinculada ou o volume que gere o /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 próprio sistema de ficheiros do contentor deve permanecer descartável.

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, parte do estado importante pode ficar retida dentro do contentor e desaparecer quando esse ambiente de execução for substituído.

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

Mova pelo menos uma cópia de segurança encriptada para 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 falha do dispositivo de armazenamento. Mantenha 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 que falhou.

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 transferiu as novas cópias de segurança encriptadas para o formato SecureTar v3 auditado, com encriptação moderna mais robusta, o que melhora a segurança das cópias de segurança, mas torna a custódia da chave uma parte explícita da recuperabilidade.

Crie versões da cópia 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 do qual está a tentar escapar.

Featured

ZimaCube 2 NAS Pessoal Cloud para Casa

ZimaCube2

$799.00 - $2,499.00

Buy Now

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

A configuração, por si só, pode não restaurar rádios USB, redes do anfitrião, fuso horário, passagem de dispositivos, serviços de bases de dados, MQTT ou relações com proxies inversos. 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árias para recriar o ambiente de execução.

Não coloque segredos em texto simples num repositório público apenas para versionar o ficheiro Compose. Mantenha os valores secretos numa localização protegida e documente apenas onde o processo de recuperação os obtém.

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

Execute um teste de restauro antes de a atualização se tornar uma emergência

Uma cópia de segurança não está comprovada apenas porque o arquivo existe. Restaure-a num destino isolado ou num contentor temporário, volte a ligar dispositivos e caminhos representativos quando for prático e confirme que o sistema regressa com utilizadores, painéis, integrações, automatizações, auxiliares e o estado esperado.

Utilize o teste para descobrir palavras-passe em falta, caminhos antigos 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 de um teste bem-sucedido; a memória não é um plano de recuperação.

Imediatamente antes da atualização, crie um novo ponto de recuperação, registe a versão atual do Home Assistant e da 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é que a instância atualizada sobreviva tanto a um período normal de utilização como a um reinício.

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

Atualize apenas quando os quatro elementos estiverem assegurados. Uma cópia manual da árvore de configuração pode continuar a ser uma 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.