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

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 migrações mais recentes do estado persistente.

O rollback mais seguro começa antes da primeira tentativa de reparação: preserve o estado pós-atualização com falhas, identifique a última versão e cópia de segurança conhecidas como funcionais e determine se a incompatibilidade está no Core, numa integração personalizada, num add-on ou numa base de dados externa. Um rollback só é bem-sucedido quando o runtime anterior consegue ler o estado restaurado e as funções originais da casa 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.

Preserve o Estado com Falhas Antes de Tentar Fazer o Downgrade

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 recentes feitas depois da última cópia de segurança funcional, bem como dados necessários para compreender posteriormente a incompatibilidade.

Uma regressão na restauração em 2026 demonstrou que até uma restauração de cópia de segurança aparentemente bem-sucedida pode deixar o runtime na versão errada quando o comportamento envolvente do Supervisor apresenta falhas. O relatório sobre a restauração da cópia de segurança e o rollback da versão do Core é uma boa razão para verificar a versão efetiva após a restauração, em vez de confiar na mensagem de conclusão.

Pare de fazer alterações à configuração até conhecer o caminho de recuperação. Se a atualização avariou um componente personalizado opcional, mas o resto do Home Assistant está estável, desativar esse componente pode ser mais seguro do que fazer um rollback completo. Se o Core não iniciar, a base de dados não carregar ou as automações críticas estiverem inutilizáveis, avance para o caminho de recuperação combinado do runtime e do estado.

Escolha um Ponto de Recuperação Anterior à Versão Incompatível

Identifique a última cópia de segurança feita quando a versão mais antiga do Home Assistant funcionava corretamente. Compare o respetivo carimbo temporal com quaisquer alterações importantes a automações, utilizadores, painéis ou histórico que esteja disposto a perder. O ponto de recuperação é um compromisso: restaura a compatibilidade fazendo recuar o estado persistente no tempo.

As orientações da ZimaSpace para criar um instantâneo dos dados das aplicações antes de uma atualização são a versão preventiva da mesma regra: o rollback do runtime é mais limpo quando existe uma cópia de um estado conhecido como funcional, criada antes de o novo software escrever pela primeira vez 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 associando-a a uma imagem antiga do Core. Preserve o estado atual e investigue uma correção para a versão atual ou uma reconstrução controlada. Um rollback 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 caminho de restauração suportado que recupera o ponto de recuperação selecionado e verifique se a versão pretendida do Core inicia efetivamente. 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 ao período anterior à atualização.

Um problema do Home Assistant Core sobre o downgrade de 2025.4 para 2025.3 documentou falhas do Recorder, do histórico e de integrações relacionadas quando o runtime mais antigo encontrou uma estrutura de base de dados mais recente. A resposta do responsável afirma explicitamente que o rollback depende da restauração de uma cópia de segurança, e não de um caminho de downgrade da base de dados no local.

Restaure bases de dados externas e 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 saudáveis e permanecer inalterados; concentre o rollback nos componentes cujo contrato de versão ou de estado tenha realmente mudado.

Featured

ZimaCube 2 NAS Pessoal Cloud para Casa

ZimaCube2

$799.00 - $2,499.00

Buy Now

Valide a Falha Original Antes de Reativar as Atualizações Automáticas

Após o rollback, 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. Em seguida, reinicie o Home Assistant e reinicie o anfitrião uma vez.

Conserve a cópia do estado com falhas e as notas da atualização até que a versão seguinte ou a correção tenha sido testada. Se uma integração personalizada tiver causado a incompatibilidade, verifique as versões suportadas antes da próxima atualização do Core. Se o próprio rollback falhar, não alterne repetidamente entre versões usando a mesma base de dados mutável; regresse ao ponto de recuperação limpo ou avance para uma reconstrução com restauração seletiva.

Considere o processo concluído quando a versão antiga e o estado restaurado permanecerem estáveis durante a utilização normal e após um reinício, e a falha original tiver desaparecido. Escale o problema quando a cópia de segurança não puder ser restaurada, o runtime antigo continuar sem conseguir ler o respetivo estado ou os dados críticos não tiverem um ponto de recuperação compatível. Nesse limite, uma correção controlada para a versão atual ou uma reconstrução é mais segura do que repetir tentativas de downgrade.