Como reverter o Home Assistant em segurança após uma versão incompatível

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.

Reverta o Home Assistant utilizando um ponto de recuperação anterior à atualização que corresponda à versão mais antiga do Core; não parta do princípio de que iniciar um runtime antigo reverte as migrações mais recentes do estado persistente.

A reversão mais segura começa antes da primeira tentativa de reparação: preserve o estado com falhas após a atualização, identifique a última versão e cópia de segurança comprovadamente funcionais e determine se a incompatibilidade diz respeito ao Core, a uma integração personalizada, a um complemento ou a uma base de dados externa. A reversão só é bem-sucedida quando o runtime anterior consegue ler o estado restaurado e as funções domésticas originais voltam a funcionar. A alteração da versão e a reversão dos dados são uma única operação de recuperação, não dois botões sem relação entre si.

Preserve o estado com falhas antes de tentar reverter a versão

Não substitua a única cópia da configuração pós-atualização enquanto faz experiências. Guarde a configuração atual, os registos, os números de versão, a localização da base de dados e a funcionalidade exata que deixou de funcionar. Essa cópia pode conter alterações novas feitas desde a última cópia de segurança funcional e provas necessárias para compreender a incompatibilidade mais tarde.

Uma regressão no restauro, em 2026, demonstrou que até um restauro de cópia de segurança aparentemente bem-sucedido pode deixar o runtime com a versão errada quando o comportamento do Supervisor envolvente apresenta falhas. O relato sobre o restauro da cópia de segurança e a reversão da versão do Core é um bom motivo para verificar a versão efetiva após o restauro, em vez de confiar na mensagem de conclusão.

Pare de fazer alterações à configuração até conhecer o percurso de recuperação. Se a atualização avariou um componente personalizado opcional, mas o restante Home Assistant está estável, desativar esse componente poderá ser mais seguro do que fazer uma reversão completa. Se o Core não arrancar, a base de dados não carregar ou as automatizações críticas não puderem ser utilizadas, avance para o percurso de recuperação conjunto do runtime e do estado.

Escolha um ponto de recuperação anterior à versão incompatível

Identifique a última cópia de segurança criada enquanto a versão anterior do Home Assistant funcionava corretamente. Compare a data e hora com quaisquer alterações importantes à automatização, aos utilizadores, ao painel ou ao histórico que esteja disposto a perder. O ponto de recuperação implica uma troca: restaura a compatibilidade ao recuar no tempo o estado persistente.

As orientações da ZimaSpace para criar uma captura instantânea dos dados das aplicações antes de uma atualização são a versão preventiva da mesma regra: a reversão do runtime é mais simples quando existe uma cópia de um estado comprovadamente funcional, criada antes de o novo software começar a escrever nos dados de produção.

Se não existir uma cópia de segurança pré-atualização fiável, não tente criá-la copiando a base de dados já migrada e emparelhando-a com uma imagem antiga do Core. Preserve o estado atual e investigue uma correção para a frente ou uma reconstrução controlada. Uma reversão sem uma cópia de estado compatível pode transformar uma única funcionalidade incompatível em falhas do Recorder, do histórico ou do registo.

Restaure o runtime e o estado persistente como um par compatível

No Home Assistant OS ou numa instalação gerida, utilize o processo de restauro suportado para recuperar o ponto de recuperação selecionado e confirme que a versão pretendida do Core é efetivamente iniciada. Nas instalações em Contentor, reverter a imagem é apenas metade da operação se a versão mais recente tiver alterado os dados persistentes; restaure também a cópia de configuração correspondente, anterior à atualização.

Um problema do Home Assistant Core relativo à reversão da versão 2025.4 para a 2025.3 documentou falhas no Recorder, no histórico e em integrações relacionadas quando o runtime anterior encontrou uma estrutura de base de dados mais recente. A resposta do responsável pela manutenção afirma explicitamente que a reversão depende do restauro de uma cópia de segurança, e não de um processo de reversão da base de dados no local.

Restaure as bases de dados externas e os serviços dependentes para pontos compatíveis apenas quando a cópia de segurança do Home Assistant não os incluir. Não reverta cegamente todos os contentores. O MQTT, os proxies e os rádios podem estar a funcionar bem e permanecer inalterados; concentre a reversão nos componentes cuja versão ou contrato de estado tenha efetivamente mudado.

Valide o problema original antes de voltar a ativar as atualizações automáticas

Após a reversão, confirme a versão do Core em execução, o início de sessão, o Recorder/histórico, as integrações principais, as automações, os painéis e um dispositivo de cada protocolo crítico. Repita a ação que falhou na versão incompatível e confirme que agora funciona sem novos erros. Depois, reinicie o Home Assistant e reinicie o anfitrião uma vez.

Guarde uma cópia do estado com falhas e as notas de atualização até a versão seguinte ou a correção ter sido testada. Se uma integração personalizada tiver causado a incompatibilidade, confirme quais são as versões suportadas antes da próxima atualização do Core. Se a reversão falhar, não alterne repetidamente entre versões sobre a mesma base de dados mutável; regresse ao ponto de recuperação limpo ou opte por uma reconstrução com restauro seletivo.

Considere a reversão bem-sucedida quando a versão anterior e o estado restaurado se mantiverem estáveis durante a utilização normal e após o reinício, e o problema original tiver desaparecido. Peça ajuda quando a cópia de segurança não puder ser restaurada, quando o runtime anterior continuar sem conseguir ler o respetivo estado ou quando não existir um ponto de recuperação compatível para dados críticos. Nesse caso, uma correção controlada para a frente ou uma reconstrução é mais segura do que tentar repetidamente reverter a versão.

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.