Uma atualização falhada do contentor do Home Assistant deve, em geral, ser tratada como um problema de substituição do ambiente de execução, não como motivo para criar uma nova instalação. Se o diretório de anfitrião montado em /config estiver intacto, a forma mais segura de recuperar é preservar esse estado, verificar o mapeamento do volume, iniciar uma imagem fiável e testar a instalação existente antes de restaurar uma cópia de segurança mais antiga.
O passo perigoso é deixar um novo contentor arrancar com um caminho de anfitrião errado ou vazio. O Home Assistant poderá então apresentar o processo de integração inicial como se a configuração tivesse desaparecido, embora o estado original ainda exista noutro local do disco. Primeiro, impeça alterações, identifique o diretório de configuração de referência e não elimine o contentor ou diretório antigo até a instância recuperada ter sido testada com sucesso.
Impeça novas gravações e encontre o caminho real de /config
Pare o contentor com falhas e inspecione a definição de execução que o criou. Confirme que diretório de anfitrião ou volume com nome está mapeado para /config e, em seguida, inspecione essa localização para encontrar os seus ficheiros YAML, .storage, componentes personalizados, segredos e base de dados.
Um caso de recuperação da comunidade após uma atualização do Docker revelou que uma instância “novinha em folha” do Home Assistant se devia, na verdade, a o contentor estar a apontar para a pasta de configuração errada. Os dados persistentes não tinham sido apagados; simplesmente, o ambiente de execução de substituição não os estava a montar corretamente.
Copie ou crie uma captura do diretório de configuração atual antes de alterar permissões, caminhos ou ficheiros da base de dados. Mesmo um estado parcialmente danificado é uma pista valiosa e pode conter automatizações ou credenciais mais recentes do que a última cópia de segurança.
Recrie o ambiente de execução sem recriar a instalação
Utilize o mesmo modo de rede, fuso horário, mapeamentos de dispositivos, acesso a rádio USB, privilégios ou capacidades e montagem de anfitrião /config que o contentor funcional utilizava antes da atualização. A imagem pode ser substituída; são essas definições de execução e os dados persistentes que determinam se o serviço regressa como a mesma instância do Home Assistant.
A persistência do contentor depende da montagem no anfitrião, não do sistema de ficheiros do contentor. Um exemplo de Home Assistant Container monta um volume persistente do anfitrião diretamente em /config, pelo que recriar o ambiente de execução não recria a configuração da casa. Se esse mapeamento mudar durante uma atualização, um contentor de substituição pode parecer novo, enquanto o estado original continua a existir noutro local.
Não copie o sistema de ficheiros do contentor antigo para a imagem nova. Recrie a implementação a partir de uma definição Compose ou run documentada e volte a ligar explicitamente o estado persistente.
Reverta a imagem antes de restaurar um estado anterior
Se a montagem da configuração estiver correta, mas a nova versão do Home Assistant não iniciar ou deixar de funcionar uma integração crítica, teste a imagem anterior que se sabe estar funcional com o mesmo /config preservado. Assim, pode distinguir entre «ambiente de execução novo incompatível com o estado atual» e «estado danificado».
O fluxo de trabalho atual do Home Assistant Container separa explicitamente a imagem do estado persistente: faça primeiro uma cópia de segurança, transfira a imagem pretendida, recrie o contentor e utilize uma etiqueta de imagem específica de uma versão anterior quando for necessário fazer uma reversão. Esse é o limite de recuperação a preservar: substitua o ambiente de execução mantendo intacto o caminho de configuração autoritativo.
Ao reverter para uma versão anterior, lembre-se de que algumas atualizações migram estruturas de dados. Utilize uma cópia de segurança feita antes da migração se a versão anterior não conseguir ler com segurança o estado já atualizado pela versão mais recente. Não alterne repetidamente entre versões usando a única cópia dos dados persistentes.
Restaure uma cópia de segurança apenas quando o estado atual não for fiável
Utilize uma cópia de segurança quando a configuração persistente estiver em falta, corrompida, parcialmente substituída ou já não for compatível com a versão que consegue executar em segurança. Sempre que possível, restaure para um destino isolado ou limpo, para poder comparar o estado recuperado com a cópia danificada.
Mantenha a palavra-passe de encriptação ou o kit de emergência necessário para abrir a cópia de segurança fora do anfitrião que falhou. Uma cópia de segurança que só exista no mesmo disco ou que não possa ser desencriptada não permite recuperar os dados.
O exemplo da ZimaSpace de separar a recuperação do Home Assistant do próprio anfitrião de armazenamento reforça a mesma regra: os dados da aplicação precisam de um caminho de restauro independente, não apenas de um disco ativo espelhado.
Valide o Contentor Recuperado Antes de Eliminar Qualquer Elemento
- Confirme que os utilizadores, painéis, integrações, automatizações, auxiliares e áreas esperados estão presentes.
- Verifique o caminho de um dispositivo local e o de um dispositivo sem fios, caso utilize Zigbee, Z-Wave ou Bluetooth.
- Verifique se há erros de base de dados ou de migração no Recorder.
- Reinicie o contentor recuperado e confirme que o mesmo estado é restaurado.
- Mantenha a etiqueta da imagem antiga, uma cópia da configuração e a última cópia de segurança conhecida como funcional até esta segunda inicialização ser concluída com êxito.
Se a imagem antiga funcionar com a configuração original, a atualização falhada deveu-se sobretudo a um problema do ambiente de execução/versão. Se todas as imagens falharem com o mesmo estado, avance para a reparação da configuração ou o restauro de uma cópia de segurança. Se um contentor novo só funcionar com um /config vazio, não considere a nova configuração como «resolvida» até perceber o que impede a recuperação no estado persistente.
Perguntas frequentes
Devo eliminar o contentor do Home Assistant que falhou antes de investigar o problema?
Não. Pare primeiro o contentor e preserve a respetiva definição de execução e o caminho da configuração montada. Pode criar um contentor de substituição sem eliminar o que falhou, mantendo disponíveis as informações necessárias para reverter enquanto confirma o novo ambiente de execução.
Porque é que o Home Assistant apresenta o ecrã de configuração inicial após uma atualização?
A razão mais comum, específica dos contentores, é o novo ambiente de execução não encontrar o caminho original /config. Verifique a montagem no anfitrião antes de concluir que a configuração foi apagada ou de restaurar uma cópia de segurança antiga por cima de um estado mais recente.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



