Se a versão do Immich apresentada no ZimaOS for mais antiga do que a versão upstream do Immich e a App Store não disponibilizar um botão Atualizar, existem formas de atualizar manualmente os contentores — mas o método correto depende do pacote Immich do ZimaOS que instalou. O tópico da IceWhale Community de dezembro de 2025 confirmou uma simples alteração da tag da imagem para o pacote Immich do BigBear, enquanto respostas posteriores mostraram que o mesmo truque não atualizava de forma fiável todos os outros pacotes Immich.
O método da comunidade consistia em abrir as definições da aplicação e alterar apenas as immich-server e immich-machine-learning tags das imagens para a versão de destino, deixando os separadores da base de dados e do Redis inalterados. O autor original confirmou que a atualização decorreu sem problemas e, mais tarde, outro utilizador do BigBear conseguiu passar da v2.3.1 para a v2.4.1. No entanto, a documentação atual do Immich exige que os administradores leiam as notas de lançamento, façam uma cópia de segurança da base de dados e tenham em conta alterações ao Compose/à base de dados antes de atualizar. Isto significa que a alteração manual das tags não deve ser tratada como um botão universal de atualização “sempre seguro”.
Primeiro, identifique qual o pacote Immich que instalou
O tópico contém pelo menos dois caminhos de implementação:
- Immich do BigBear: vários utilizadores relataram que editar as tags das imagens no ZimaOS acionou com sucesso uma atualização.
- Pacote original/não BigBear: mais tarde, um utilizador relatou ter ficado preso na v2.1.0, mesmo depois de tentar alterar manualmente as versões do servidor e do machine learning.
Abra as definições da aplicação Immich no ZimaOS e registe os nomes atuais das imagens, as tags, os mapeamentos de volumes, a imagem da base de dados e as variáveis de ambiente antes de alterar qualquer coisa. Não presuma que as instruções escritas para a definição do BigBear correspondem a outro modelo da App Store.
A atualização da tag do BigBear que funcionou na comunidade
O procedimento comunitário bem-sucedido foi:
- No painel do ZimaOS, abra o menu de três pontos da aplicação Immich.
- Selecione Definições.
- Abra o separador immich-machine-learning.
- Altere a Tag da imagem para a versão pretendida do Immich.
- Abra o separador immich-server.
- Defina aí a mesma tag de lançamento.
- Deixe os separadores da base de dados e do Redis inalterados, salvo indicação explícita nas notas de lançamento para alterar a base de dados ou o contentor.
- Guarde a configuração e deixe o ZimaOS recriar/descarregar os contentores afetados.
Na altura da resposta original, a tag de exemplo era:
v2.3.1Essa versão é histórica. Mais tarde, outro utilizador atualizou para v2.4.1, e uma resposta de abril de 2026 mencionou v2.7.4. Não copie hoje nenhum desses números de versão antigos. Escolha uma versão de destino apenas depois de consultar as notas de lançamento atuais do Immich e o seu caminho de atualização.
O que o autor original confirmou
Depois de receber as instruções sobre as tags do BigBear, MikeFrizz respondeu que a dica foi muito útil e que a atualização foi concluída sem problemas. Este é o resultado confirmado mais sólido no tópico de origem.
Essa confirmação apoia o método para o pacote e o contexto de versão utilizados pelo autor original. Não prova que editar manualmente duas etiquetas seja suficiente para todas as futuras versões principais do Immich ou para todos os pacotes do ZimaOS.
Não presuma que a etiqueta «latest» resolverá o problema
Um utilizador alterou a etiqueta para latest, mas o ZimaOS voltava repetidamente à versão anteriormente instalada. O tópico contém depois sugestões, como tentar versão, mas não existe uma correção universal confirmada pela fonte com base nesses nomes genéricos de etiquetas.
A documentação atual do Immich utiliza uma variável de versão explícita e suporta metaetiquetas de versões principais no seu próprio fluxo de trabalho do Docker Compose. Numa aplicação empacotada do ZimaOS, utilize o formato de etiqueta que a definição do pacote e a imagem a montante suportarem efetivamente. Evite inventar etiquetas porque um nome parece plausível.
Faça uma cópia de segurança do Immich antes de alterar as versões
A documentação atual do Immich recomenda explicitamente fazer uma cópia de segurança da base de dados antes de atualizações que possam envolver migrações. As suas fotografias e vídeos também precisam de uma estratégia de cópia de segurança independente; uma cópia de segurança da base de dados não substitui a própria biblioteca multimédia.
Utilize o guia de cópia de segurança e recuperação do Immich atual antes de uma mudança manual de versão.
No mínimo, preserve:
- a cópia de segurança da base de dados do Immich;
- os dados da biblioteca multimédia/dos carregamentos;
- a configuração atual da aplicação do ZimaOS e os mapeamentos de volumes;
- as etiquetas atuais das imagens;
- e quaisquer variáveis de ambiente ou localizações de armazenamento personalizadas.
Leia as notas da versão do Immich antes de cada mudança de versão
A documentação atual de atualização do Immich indica que os administradores devem consultar as notas da versão para verificar alterações incompatíveis antes de atualizar. O processo normal do Docker Compose a montante é:
docker compose pull && docker compose up -dmas apenas depois de a definição do Compose e as variáveis de versão serem adequadas à versão pretendida.
Consulte o guia de atualização do Immich atual.
Isto é importante no ZimaOS, porque uma aplicação empacotada pode ficar desatualizada não só nas etiquetas das imagens, mas também na sua definição equivalente ao Compose. Uma versão mais recente immich-server a imagem pode exigir alterações na base de dados, no ambiente, nas verificações de estado ou nos volumes que um pacote mais antigo não inclui.
Mantenha as versões do servidor e da aprendizagem automática do Immich compatíveis
A comunidade alterou especificamente as etiquetas de ambos immich-server e immich-machine-learningA documentação atual do Immich também alerta que incompatibilidades de versão entre o servidor principal e os componentes de aprendizagem automática podem causar erros ou instabilidade.
Não atualize apenas um dos dois porque, por acaso, mostrou primeiro uma imagem disponível. Trate-os como uma única versão coordenada da aplicação, salvo indicação explícita em contrário na documentação da versão atual.
Não altere aleatoriamente a etiqueta do contentor da base de dados
O conselho da comunidade para deixar o separador da base de dados inalterado era sensato para as atualizações secundárias específicas do BigBear aí discutidas. A camada PostgreSQL do Immich tem as suas próprias migrações e mudou ao longo do tempo, incluindo a migração de extensões vetoriais mais antigas para VectorChord.
- Não altere a versão da imagem da base de dados apenas para que todas as etiquetas pareçam numericamente semelhantes.
- Não presuma que a imagem da base de dados nunca deve mudar; se as notas de lançamento atuais do Immich exigirem uma migração da base de dados/Compose, siga essa migração documentada.
E se a aplicação Immich original do ZimaOS continuar numa versão antiga?
Uma resposta de março de 2026 indicou que o utilizador não estava a executar a versão da App Store do BigBear e continuava bloqueado no Immich v2.1.0, mesmo depois de tentar atualizar manualmente as imagens de aprendizagem automática e do servidor. O tópico não contém uma resolução confirmada para a implementação do pacote original desse utilizador.
Este é um limite importante: se a alteração manual das etiquetas das imagens não atualizar a aplicação, pare de repetir a mesma operação. Compare a definição atual dos contentores do pacote com os requisitos atuais do Compose do Immich e considere migrar para um pacote ZimaOS mantido apenas depois de fazer uma cópia de segurança e confirmar os caminhos dos dados.
Não desinstale um pacote Immich funcional antes de saber onde estão armazenados os respetivos volumes da base de dados e dos ficheiros multimédia.
Porque é que os utilizadores da comunidade sugeriram o pacote Immich do BigBear
A primeira resposta recomendou a aplicação Immich do BigBear porque, normalmente, se mantinha mais próxima das versões lançadas pelo projeto original. As instruções posteriores, bem-sucedidas, para editar etiquetas também foram testadas explicitamente no BigBear.
Isto não torna a “reinstalação do BigBear” um processo seguro de migração com um clique para uma biblioteca existente. Um pacote novo pode utilizar nomes de volumes, diretórios de dados, imagens da base de dados ou variáveis de ambiente diferentes. Considere a migração do pacote uma operação separada da atualização de uma stack existente.
Tenha cuidado com os atualizadores automáticos de contentores
Uma resposta da comunidade, em abril de 2026, sugeriu o Tugtainer como alternativa mais simples ao Watchtower para verificar e atualizar automaticamente contentores. Essa sugestão pode ser conveniente para serviços sem estado, mas o Immich é uma aplicação com vários contentores e com estado, que utiliza uma base de dados PostgreSQL e tem procedimentos documentados para atualizações com alterações incompatíveis.
No caso do Immich, a substituição automática de imagens sem ler as notas de lançamento pode ser arriscada. A documentação atual do Immich indica explicitamente que os administradores devem ter em conta alterações incompatíveis antes de efetuarem atualizações. Se utilizar de todo um atualizador automático de contentores, prefira notificações/aprovação manual para o Immich em vez de atualizar cegamente cada nova etiqueta.
Fluxo de atualização mais seguro do Immich no ZimaOS
- Registe se o pacote instalado é o BigBear ou outra definição do Immich.
- Registe as imagens/etiquetas atuais do servidor, da aprendizagem automática, da base de dados e do Redis.
- Faça uma cópia de segurança da base de dados do Immich e dos ficheiros multimédia importantes.
- Leia as notas de lançamento upstream para cada fronteira de alterações incompatíveis entre as versões atual e pretendida.
- Confirme se a versão pretendida requer alterações ao Compose, à base de dados, às variáveis de ambiente ou ao armazenamento.
- Para uma atualização de versão secundária compatível do BigBear, altere em conjunto as etiquetas do servidor e da aprendizagem automática, tal como a comunidade fez.
- Mantenha as imagens da base de dados/Redis inalteradas, salvo se o caminho de atualização documentado exigir especificamente uma alteração.
- Guarde as definições da aplicação e observe os registos do contentor enquanto as novas imagens iniciam.
- Verifique a versão na interface Web do Immich, os carregamentos, as miniaturas, a aprendizagem automática e a biblioteca existente antes de eliminar imagens antigas.
- Se o pacote reverter imediatamente ou permanecer na versão antiga, inspecione a definição do pacote em vez de continuar a forçar etiquetas.
O que verificar após uma atualização do Immich
- A interface Web carrega e apresenta a versão pretendida do servidor.
- A aplicação móvel consegue ligar-se e é compatível com a versão principal do servidor.
- As fotografias e os vídeos existentes abrem corretamente.
- Os novos carregamentos são concluídos com êxito.
- As tarefas de miniaturas e transcodificação são executadas.
- As funcionalidades de aprendizagem automática iniciam-se sem erros de incompatibilidade de versão.
- O contentor PostgreSQL continua saudável.
A documentação atual do Immich salienta que fazer downgrade não é uma estratégia de recuperação suportada. Uma cópia de segurança é mais segura do que presumir que pode simplesmente repor a etiqueta após uma migração da base de dados.
Perguntas frequentes sobre a atualização do Immich no ZimaOS
Posso atualizar o Immich alterando as etiquetas das imagens do ZimaOS?
Sim, para algumas combinações de pacote/versão. O autor original e outro utilizador do BigBear confirmaram que alterar ambas as etiquetas, do servidor e da aprendizagem automática, funcionou. O tópico também contém um utilizador que não era do BigBear, para quem o método não resolveu o problema da instalação desatualizada.
Que etiquetas do Immich devo alterar?
No método comunitário BigBear confirmado, as immich-server e immich-machine-learning as etiquetas foram alteradas em conjunto. Não copie os exemplos antigos v2.3.1, v2.4.1 ou v2.7.4 como versões de destino atuais.
Devo utilizar latest?
Não como solução universal. Um utilizador no tópico relatou que latest não se manteve. Utilize o esquema de versões suportado pelo seu pacote efetivo e pelas orientações atuais do Immich.
Posso simplesmente executar docker pull?
Extrair apenas uma nova imagem não recria o contentor em execução nem aplica alterações do Compose. O Immich upstream utiliza docker compose pull && docker compose up -d depois de a configuração estar preparada para a versão pretendida.
O Tugtainer ou o Watchtower devem atualizar automaticamente o Immich?
As atualizações automáticas podem ignorar a análise das notas de lançamento e das migrações que o Immich recomenda explicitamente. Numa aplicação com estado e uma base de dados, é mais seguro receber uma notificação e fazer atualizações manuais controladas do que substituir tudo automaticamente às cegas.
Preciso de uma cópia de segurança antes de atualizar o Immich?
Sim. A documentação atual do Immich sobre atualizações e cópias de segurança recomenda proteger a base de dados antes das atualizações, e deve proteger separadamente os ficheiros multimédia insubstituíveis.
