A solução alternativa da fonte foi prática para um pacote do Immich de 2025, mas não deve ser fixada num tutorial de atualização atual. Um utilizador da comunidade alterou manualmente a servidor do immich e aprendizagem automática do immich etiquetas de imagem para v1.134.0. O autor original disse que isso acabou por funcionar no seu sistema ZimaOS principal, mas não numa VM de teste.
Entretanto, o Immich passou para a v3 e o seu modelo de implementação mantido utiliza uma stack completa do Docker Compose, juntamente com um valor IMMICH_VERSION. Atualizar apenas uma ou duas etiquetas de serviço pode criar uma stack com versões mistas quando as premissas da base de dados, da cache, da aprendizagem automática ou da API tiverem mudado.
A fonte de 2025 editou as etiquetas individuais dos serviços do Immich
A comunidade disse ao utilizador para alterar tanto o servidor como a aprendizagem automática
CogZog disse que ambas servidor do immich e aprendizagem automática do immich deve usar a nova etiqueta. O utilizador confirmou que tinha alterado ambas, mas a VM de teste continuava na versão mais antiga.
A compilação principal do ZimaOS acabou por atingir a v1.134.0
A fonte não estabeleceu nenhuma regra para atualizar manualmente a imagem da base de dados
beep perguntou se a base de dados também deveria ser mudada para uma etiqueta mais recente/estável. A resposta da comunidade foi essencialmente «se não está avariado, não o conserte». Isso foi uma opinião, não uma política de migração do Immich.
A versão atual do Immich é a v3, com um processo completo de atualização do Compose
O Immich v3.0.0 foi lançado em julho de 2026. A fonte oficial indica que, para atualizar a stack mantida, deve definir IMMICH_VERSION=v3 e executar o processo normal de pull/recriação do Compose, consultando também as notas sobre alterações incompatíveis/migração da v3.
Consulte as orientações atuais para a versão v3 do Immich.
A recomendação atual do projeto upstream é utilizar o pacote completo do Docker Compose
A documentação de instalação atual do Immich indica aos utilizadores que descarreguem a versão docker-compose.yml e .env, depois defina as localizações e IMMICH_VERSION. O caminho da base de dados PostgreSQL deve permanecer num sistema de ficheiros local compatível, e não numa partilha de rede.
Utilize o modelo Compose atual do Immich para implementações manuais/personalizadas.
Para o pacote da App Store do ZimaOS, preferir o processo de atualização atual da aplicação
A App Store 2.0 atual do ZimaOS inclui a gestão das atualizações das aplicações instaladas. Se o pacote da loja disponibilizar uma atualização do Immich, deixe que a definição do pacote atualize toda a configuração de vários serviços, em vez de editar independentemente a etiqueta de um único serviço.
Efetuar uma cópia de segurança antes de uma atualização principal do Immich
Proteja a biblioteca de fotografias/vídeos e o estado da base de dados/aplicação antes de uma alteração de versão principal. Só um diretório de biblioteca íntegro não é suficiente para reconstruir álbuns, utilizadores, metadados e o estado da aplicação.
Evitar criar uma configuração do Immich com versões misturadas
O Immich não é um único contentor independente. A aplicação, o serviço de aprendizagem automática, a base de dados e outros componentes de suporte são testados como uma topologia de lançamento coordenada. Atualizar uma imagem enquanto outra permanece fixada pode causar incompatibilidades na API, no esquema ou no arranque.
A origem só funcionou depois de a configuração efetiva do utilizador ter ficado suficientemente alinhada para executar a v1.134.0; isto não demonstra que seja seguro misturar etiquetas arbitrárias.
Manter o PostgreSQL num armazenamento local compatível
Os requisitos atuais do Immich indicam que o diretório de dados do PostgreSQL deve utilizar um sistema de ficheiros local e não deve estar numa partilha de rede. O estado da base de dados é normalmente pequeno em comparação com a biblioteca de fotografias, mas é essencial para os utilizadores, álbuns, metadados e o estado da aplicação.
Saiba se instalou o pacote do ZimaOS ou uma stack Compose personalizada
Se o Immich veio da App Store do ZimaOS, utilize o método de atualização atual da loja e reveja as alterações ao pacote. Se importou a sua própria Compose, é responsável pela fixação da versão da fonte, .env, o caminho da base de dados e os passos de migração.
Misturar edições da App Store com uma stack da fonte mantida manualmente torna mais difícil a resolução de problemas no futuro.
Faça uma verificação antes da atualização principal
- Confirme que existe uma cópia de segurança recente da biblioteca de fotografias.
- Faça uma cópia de segurança do estado da base de dados/aplicação.
- Registe a versão atual e os mapeamentos de volumes.
- Leia as notas sobre alterações incompatíveis da fonte.
- Certifique-se de que a unidade do sistema/AppData tem espaço livre suficiente para transferências de imagens e migrações.
Verificar a versão em execução e as tarefas após a atualização
Não fique por “Guardado com êxito”. Abra a página Sobre/Sistema do Immich, confirme a versão do servidor em execução, verifique o estado dos contentores e, em seguida, valide os carregamentos, as miniaturas, as tarefas de aprendizagem automática e a conectividade da aplicação móvel.
A própria fonte demonstra porquê: editar a etiqueta não significou imediatamente que a instância em execução tivesse sido realmente atualizada.
A reversão nem sempre consiste apenas em alterar novamente a etiqueta
Depois de uma versão principal migrar o esquema ou o estado da base de dados, poderá não ser possível fazer o downgrade de uma imagem. Siga as orientações de migração/reversão e faça cópias de segurança, em vez de presumir que uma etiqueta anterior é um botão universal para desfazer alterações.
FAQ sobre atualizações do Immich
O método de etiquetas manual de 2025 funcionou no sistema principal do utilizador da fonte?
Sim, eventualmente. A máquina virtual de teste não se comportou da mesma forma.
Os utilizadores atuais do Immich devem atualizar apenas as etiquetas do immich-server e do machine-learning?
Não. Atualmente, o Immich v3 é mantido como uma stack Compose completa, com orientações sobre versões e migrações.
A IceWhale prometeu atualizações automatizadas do Immich na fonte?
Não. O Zima-Giorgio apenas disse que a equipa iria discutir o pedido.
