Porque é que o Home Assistant perde o acesso aos dados persistentes após a recriação da stack?

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.

Recriar uma pilha Docker ou Compose do Home Assistant não deverá apagar a configuração se os mesmos dados persistentes de /config forem novamente montados. Se surgir o ecrã de configuração inicial ou parecer que faltam integrações após a recriação, a primeira hipótese deverá ser que o novo contentor está a ver uma vista de armazenamento diferente, não que o Home Assistant tenha apagado o estado da casa.

Inspecione a montagem efetiva, o caminho no anfitrião, o volume com nome, os ficheiros ocultos e as permissões antes de restaurar uma cópia de segurança mais antiga. Um diretório vazio incorreto pode parecer exatamente uma perda de configuração, embora os dados originais permaneçam intactos noutro local do anfitrião.

Verifique o que está realmente montado em /config

Inspecione o contentor em execução e confirme a origem da montagem mapeada para /config. Compare-a com o ficheiro Compose antigo ou com o registo de implementação, em vez de confiar num nome de pasta que pareça familiar.

As montagens bind do Docker substituem a vista que o contentor tem do diretório de destino, e a documentação atual sobre montagens bind salienta que montar um diretório do anfitrião sobre um caminho não vazio do contentor oculta os ficheiros que já lá estavam. Por isso, um caminho de origem vazio ou incorreto faz com que o Home Assistant veja um /config vazio.

Não execute a configuração inicial nem comece a criar novas integrações até confirmar a montagem. Novas gravações no diretório errado tornam a recuperação posterior mais confusa.

Distinga montagens bind de volumes com nome

Uma pilha Compose pode usar um caminho explícito no anfitrião ou um volume com nome gerido pelo Docker. Recriar um projeto com um nome de projeto, nome de volume ou caminho diferente pode criar um novo armazenamento persistente vazio, enquanto o volume antigo continua a existir.

Um guia atualizado sobre volumes do Docker explica que os volumes com nome armazenam dados independentemente de cada contentor e podem voltar a ser anexados depois de um contentor ser substituído. Por isso, remover um contentor é diferente de remover ou substituir o respetivo armazenamento persistente.

Liste os volumes antigos e novos, inspecione os respetivos pontos de montagem através do Docker e compare as datas de criação e os conteúdos. Evite comandos de limpeza até saber qual dos volumes contém o estado autoritativo do Home Assistant.

Os ficheiros ocultos podem fazer uma cópia parecer completa quando não está

O Home Assistant armazena estado importante gerido pela interface em caminhos ocultos, como .storage. Uma cópia na shell que use um padrão como *, ou um gestor de ficheiros que oculte os ficheiros ocultos, pode copiar ficheiros YAML e deixar silenciosamente para trás dados críticos dos registos e das integrações.

Um caso de migração do Docker para o Compose, reproduzido em 2025, demonstrou exatamente este problema: uma operação de cópia ignorou ou tratou incorretamente o estado oculto do Home Assistant, e a migração só estabilizou depois de toda a árvore de configuração e os metadados terem sido copiados corretamente.

Compare listagens de diretórios que incluam ficheiros ocultos e verifique a propriedade, as datas e a presença dos diretórios ocultos esperados antes de concluir que os próprios dados estão danificados.

Verifique as permissões antes de voltar a copiar os dados

O diretório correto pode continuar a parecer inutilizável se o contentor recriado não tiver permissão para o ler ou escrever. Isto é comum depois de mover os dados para um novo sistema de ficheiros, alterar o modo do Docker, restaurar a partir de outro anfitrião ou alterar os mapeamentos de UID/GID.

Um guia de resolução de problemas do Docker Engine, verificado em 2026, identifica como causas destas falhas o caminho real no anfitrião, o UID/GID do contentor, o acesso ao diretório principal, o modo de montagem e os limites de segurança. Uma incompatibilidade de permissões de leitura ou de propriedade pode impedir o Home Assistant de atualizar o estado, mesmo quando os ficheiros estão visíveis.

Corrija o problema específico de propriedade ou montagem em vez de aplicar permissões de escrita para todos a toda a árvore de configuração.

Recrie a stack apenas depois de confirmar o caminho persistente

Use a definição Compose, a etiqueta da imagem, o modo de rede, os dispositivos e a origem de /config exatos que sabe que funcionam. Inicie o Home Assistant e confirme que os utilizadores, painéis, integrações, automatizações e auxiliares esperados voltaram antes de permitir migrações ou novas alterações de configuração.

O fluxo de recuperação de um único contentor do ZimaSpace aplica a mesma regra: inspecione as montagens efetivas e volte a ligar as dependências funcionais antes de restaurar ou substituir partes não relacionadas de uma stack.

Se os dados autoritativos estiverem realmente em falta, avance para a recuperação a partir da cópia de segurança. Se estiverem presentes, mas o novo contentor não os conseguir ver ou modificar, o problema está no mapeamento do armazenamento ou nas permissões, não na própria configuração do Home Assistant.

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.