Immich 업데이트 태그와 ZimaOS 버전 경계 설명

ZimaOS에서 Immich를 사용하던 한 사용자가 애플리케이션 이미지로 latest를 선택했지만, 설치된 서버는 이전 릴리스에 그대로 머무는 현상을 겪었습니다. 논의에 따르면 Immich 업데이트에는 서버와 머신 러닝이라는 최소 두 개의 컨테이너가 관련될 수 있으며, Immich와 ZimaOS가 함께 발전하면서 올바른 업데이트 방법도 달라졌습니다.

이는 언제나 적용되는 업그레이드 방법이 아니라, 버전에 따라 달라지는 커뮤니티 기록입니다. 초기 답변은 ZimaOS 1.3.1-1에서 Immich 1.123~1.125를 사용하던 시기의 내용이며, 이후 공식 안내에서는 ZimaOS 1.5.1이 구버전 Immich를 버전 2로 업그레이드하고 데이터베이스를 전환하는 과정을 처리한다고 설명합니다.

초기 사례에서 latest를 선택하는 것만으로는 충분하지 않았던 이유

원래 사용자는 latest를 선택했지만 더 새로운 서버 이미지를 받지 못했습니다. 또 다른 참여자는 Immich 1.123에서 멈춰 있다고 보고했습니다. 커뮤니티 답변에서는 한 서비스만 변경하지 말고 immich-server와 immich-machine-learning의 이미지 설정을 모두 확인하라고 안내했습니다.

ZimaOS 앱 설정에 표시된 Immich 서버 및 머신 러닝 이미지 태그 — 답변에서는 두 Immich 서비스에 별도의 이미지 설정이 있다는 점을 강조했습니다.

참여자들은 화면에 표시된 latest가 항상 기대한 이미지로 이어지는 것은 아니라고도 경고했습니다. 명시적인 릴리스 태그를 입력해 보았지만, 스크린샷에 따르면 ZimaOS 1.3.1-1의 모든 사례에서 태그 입력만으로 문제가 해결되지는 않았습니다.

정확한 태그 구문이 중요했지만, 그것이 전부는 아니었습니다

한 문제 해결 과정에서는 수동으로 입력한 버전이 게시된 이미지 태그와 정확히 일치하지 않는다는 점이 확인되었습니다. 답변자는 스레드에서 참조된 컨테이너 태그 목록을 확인하고, 저장한 뒤 다시 시작하기 전에 두 서비스 모두에 동일한 명시적 버전을 사용하라고 제안했습니다.

ZimaOS에서 Immich 애플리케이션 버전이 1.123으로 유지되는 모습 — 한 사용자가 설치된 Immich 버전이 1.123으로 유지되는 모습을 보여 주었습니다.

ZimaOS 설정에 입력한 명시적 Immich 이미지 버전 — latest로 앱이 새로 고쳐지지 않자 명시적인 버전을 테스트했습니다.

업데이트 문제 해결 중 표시된 Immich 머신 러닝 컨테이너 태그 — 서버 이미지와 함께 머신 러닝 이미지도 고려해야 했습니다.

업데이트 문제 해결 중 표시된 Immich 서버 컨테이너 태그 — 같은 시도에서 표시된 서버 태그입니다.

해당 시도를 진행한 작성자는 답변에서 제안된 두 태그 변형 모두 업그레이드를 완료하지 못했다고 보고했습니다. 이 실패 결과는 중요합니다. 스레드의 내용만으로는 특정 1.125 태그를 구형 앱 패키지에 보편적으로 적용할 수 있는 해결책으로 제시할 수 없습니다.

이후 사용자들은 두 컨테이너를 모두 Immich 2.2.3으로 업데이트했습니다

2025년 11월, Immich 2.1.0을 사용하던 한 참여자는 latest로도 여전히 업데이트되지 않는다고 보고했습니다. 해당 사용자는 머신 러닝과 서버 컨테이너 모두에서 버전 2.2.3을 수동으로 선택해 성공적으로 업데이트했으며, 다른 참여자도 자신의 설치 환경에서 같은 방식의 변경이 작동했다고 확인했습니다.

Zima 팀의 Giorgio는 별도의 버전 기준을 덧붙였습니다. ZimaOS 1.5.1에서는 Immich 앱을 구버전에서 버전 2로 업그레이드할 수 있으며, 업데이트 버튼을 선택하면 ZimaOS가 백그라운드에서 데이터베이스 문제를 처리한다고 설명했습니다. 이 공식 안내는 이후의 1.5.1 작업 흐름에 해당하며, 스레드 초반의 1.3.1-1 스크린샷에는 적용되지 않습니다.

큰 폭의 버전 업그레이드에는 별도의 마이그레이션 경로가 필요할 수 있습니다

2026년 5월의 한 답변에서는 매우 오래된 Immich 설치 환경의 경우 최신 릴리스로 바로 건너뛰기보다 여러 번의 소규모 업데이트를 거쳐야 할 수 있다고 설명했습니다. 스레드에는 모든 중간 버전의 검증된 순서가 제시되어 있지 않으므로, 이 내용은 검증된 마이그레이션 표가 아니라 커뮤니티 조언으로 보아야 합니다.

이 스레드에서 얻을 수 있는 종합적인 교훈은 변경하기 전에 ZimaOS 릴리스, 현재 Immich 버전, 이미지 소스, 그리고 두 관련 서비스의 태그를 확인해야 한다는 것입니다. 2.x의 마이너 업데이트에서 보고된 해결 방법을 훨씬 오래된 1.x 데이터베이스 마이그레이션에 그대로 적용해서는 안 됩니다.