Solução da comunidade

Porque é que o Immich não foi atualizado a partir das definições da aplicação ZimaOS

Users found that selecting latest did not always refresh Immich. Replies tested matching tags for the server and machine-learning containers, then documented newer ZimaOS support for major database transitions.

Um utilizador do Immich no ZimaOS selecionou latest para a imagem da aplicação, mas verificou que o servidor instalado continuava numa versão mais antiga. A discussão mostra que uma atualização do Immich pode envolver pelo menos dois contentores — o servidor e a aprendizagem automática — e que o procedimento correto mudou à medida que o Immich e o ZimaOS evoluíram.

Esta é uma descrição histórica da comunidade, dependente das versões, e não um procedimento de atualização universal. As primeiras respostas dizem respeito ao Immich 1.123–1.125 no ZimaOS 1.3.1-1; orientações oficiais posteriores descrevem o ZimaOS 1.5.1 a tratar de uma atualização de versões mais antigas do Immich para a versão 2, incluindo a transição da base de dados.

Porque selecionar latest não foi suficiente no caso inicial

O utilizador original tinha latest selecionado, mas não recebeu uma imagem de servidor mais recente. Outro participante relatou ter ficado bloqueado no Immich 1.123. Uma resposta da comunidade recomendou verificar as definições das imagens de immich-server e immich-machine-learning, em vez de alterar apenas um dos serviços.

Etiquetas das imagens do servidor e da aprendizagem automática do Immich nas definições da aplicação do ZimaOS
A resposta destacou definições de imagem separadas para os dois serviços do Immich.

Os participantes também avisaram que a palavra visível latest nem sempre resultava na imagem esperada. Experimentaram etiquetas de versão explícitas, mas as capturas de ecrã mostram que introduzir uma etiqueta não resolveu todos os casos no ZimaOS 1.3.1-1.

A sintaxe exata da etiqueta era importante, mas não era toda a solução

Num ramo da resolução de problemas, observou-se que a versão introduzida manualmente não correspondia exatamente à etiqueta da imagem publicada. A resposta encaminhou os utilizadores para a lista de etiquetas de contentores referida na discussão e sugeriu utilizar a mesma versão explícita nos dois serviços antes de guardar e reiniciar.

Versão da aplicação Immich mantida na 1.123 no ZimaOS
Um utilizador mostrou que a versão instalada do Immich continuava na 1.123.
Versão explícita da imagem do Immich introduzida nas definições do ZimaOS
Foi testada uma versão explícita depois de latest não atualizar a aplicação.
Etiqueta do contentor de aprendizagem automática do Immich apresentada durante a resolução de problemas da atualização
A imagem de aprendizagem automática também teve de ser considerada juntamente com a imagem do servidor.
Etiqueta do contentor do servidor Immich apresentada durante a resolução de problemas da atualização
A etiqueta correspondente do servidor apresentada na mesma tentativa.

O autor dessa tentativa relatou que nenhuma das variações de etiquetas sugeridas nas respostas concluiu a atualização. Esse resultado falhado é importante: a discussão não sustenta a apresentação de uma determinada etiqueta 1.125 como solução universal para o pacote de aplicação mais antigo.

Utilizadores posteriores atualizaram ambos os contentores para o Immich 2.2.3

Em novembro de 2025, um participante que utilizava o Immich 2.1.0 relatou que latest continuava a falhar. Selecionar manualmente a versão 2.2.3 para os contentores de aprendizagem automática e do servidor funcionou para esse utilizador, e outro participante confirmou que a mesma alteração conjunta funcionou na sua instalação.

Giorgio, membro da equipa do Zima, acrescentou uma delimitação de versões distinta: no ZimaOS 1.5.1, a aplicação Immich podia ser atualizada de versões mais antigas para a versão 2, com o ZimaOS a tratar do problema da base de dados em segundo plano depois de selecionar o botão de atualização. Essa declaração oficial aplica-se ao procedimento posterior do 1.5.1, não às capturas de ecrã do 1.3.1-1 no início da discussão.

Saltos grandes entre versões podem exigir o seu próprio procedimento de migração

Uma resposta de maio de 2026 afirmou que instalações muito antigas do Immich podem ter de passar por atualizações menores, em vez de saltarem diretamente para a versão mais recente. A discussão não fornece uma sequência testada de todas as versões intermédias, pelo que esse comentário é apresentado como aconselhamento da comunidade, e não como uma matriz de migração verificada.

A conclusão conjunta da discussão é identificar a versão do ZimaOS, a versão atual do Immich, a origem da imagem e as etiquetas de ambos os serviços associados antes de alterar qualquer coisa. Uma correção comunicada para uma atualização secundária da versão 2.x não deve ser aplicada automaticamente a uma migração de base de dados muito mais antiga da versão 1.x.

FAQ

É necessário ter em atenção as etiquetas do servidor e da aprendizagem automática do Immich em conjunto?

Sim, nos relatos de atualizações conjuntas bem-sucedidas. Os utilizadores alteraram ambos os serviços para a mesma versão de destino, em vez de atualizarem apenas o contentor do servidor.

A etiqueta latest garante que o ZimaOS instalará a versão mais recente do Immich?

Não nesta discussão. Vários utilizadores relataram que latest os deixou numa versão mais antiga, enquanto as etiquetas explícitas só funcionaram em alguns casos posteriores.

É possível aplicar as orientações para o ZimaOS 1.5.1 ao caso do 1.3.1-1?

Não. A resposta relativa ao 1.5.1 descreve explicitamente um suporte mais recente para atualizar instalações antigas do Immich durante a transição da base de dados para a versão 2. As capturas de ecrã anteriores documentam um estado diferente da aplicação e do sistema operativo.