ZimaOS의 Immich에서 immich-server 이미지 태그만 편집한 후에도 이전 버전이 유지된다면, 컨테이너 하나씩 변경하는 작업을 중단하고 먼저 패키지/스택을 확인하세요. Immich는 여러 서비스로 구성된 애플리케이션이므로 서버, 머신 러닝, 데이터베이스, 캐시 구성 요소의 호환성을 유지해야 하며, 일부 ZimaOS 패키지는 서로 다른 App Store 출처에서 관리됩니다.
소스 스레드에서는 한 필드만 업데이트할 경우 실패할 수 있는 이유를 보여 줍니다. 사용자가 서버 이미지를 변경하고 네트워크 다운로드 활동을 확인한 후 재시작했지만 Immich에는 여전히 v2.6.1이 표시되었습니다. 다른 사용자는 서비스 이미지가 일치하는 정상적인 v3.1.0 설정을 보여 주었습니다. 따라서 올바른 가이드는 “백업하고, 스택을 확인하고, 일관되게 업데이트한 후, 검증하기”이지 “한 필드에 더 최신 숫자를 입력하기”가 아닙니다.
1단계: 설치한 Immich 패키지 확인
ZimaOS에는 공식 스토어 패키지와 서드파티/커뮤니티 스토어 패키지가 있을 수 있습니다. 앱 설정을 열고 다음 항목뿐만 아니라 모든 서비스 이미지를 기록하세요. immich-server.
또한 App Store의 출처를 기록하여 업데이트 메타데이터를 누가 관리하는지 확인하세요.
2단계: 주요 업데이트를 수행하기 전에 Immich 백업
사진 라이브러리와 PostgreSQL 데이터베이스를 백업하세요. 현재 Immich 백업 및 복원 가이드에는 데이터베이스 덤프 절차가 설명되어 있습니다.
컨테이너를 다시 생성하는 것을 백업으로 간주하지 마세요.
3단계: 모든 서비스 버전 확인
소스 비교에 나열된 항목:
- Immich 서버;
- Immich 머신 러닝;
- Postgres;
- Valkey/Redis.
전체 이미지 태그를 기록하세요. App Store에서 테스트된 번들로 관리하는 경우, 한 구성 요소만 다른 구성 요소보다 앞서 수동으로 업데이트하기보다 App Store의 업데이트 작업을 우선 사용하세요.
4단계: 사용 가능한 경우 App Store 업데이트 사용
현재 ZimaOS 문서에는 최신 Immich 패키지를 App Store에서 설치할 수 있다고 안내되어 있습니다. 업데이트 버튼을 사용할 수 있다면 해당 버튼을 사용하여 패키지 관리자의 Compose 정의도 함께 업데이트하세요.
현재 ZimaOS Immich 가이드는 현재 공식 ZimaOS 시작점입니다.
태그 하나를 편집하면 다운로드되는 것처럼 보이지만 업데이트되지 않는 이유
앱 관리자가 새 이미지를 가져오더라도 저장소 메타데이터, 다른 저장된 YAML 값 또는 다른 이미지 정의를 사용해 서비스를 다시 생성할 수 있습니다. 따라서 실행 중인 컨테이너가 이전 태그로 되돌아갈 수 있습니다.
다음 명령으로 실제 실행 중인 이미지를 확인하세요.
docker ps --format '{.Names} {.Image}'Immich 주요 버전을 무작정 건너뛰지 마세요
Immich 릴리스에는 데이터베이스/스키마 및 서비스 변경 사항이 포함될 수 있습니다. 현재 진행 중인 버전에 해당하는 업스트림 릴리스/업그레이드 안내를 읽으세요. 호환되는 조합을 추측하지 말고 스택 전체를 하나의 단위로 업데이트하세요.
BigBear 또는 기타 서드파티 패키지를 사용하는 경우
ZimaSpace 커뮤니티의 별도 가이드에서는 이미지 태그를 변경하는 방법이 일부 BigBear 패키지에서 작동했지만, 이후 사용자들은 같은 방법이 모든 패키지에 보편적으로 적용되지는 않는다는 점을 확인했다고 설명합니다. 해당 우회 방법을 적용하기 전에 패키징 소스를 확인하세요.
Immich 업데이트 가이드에서는 패키지별 경계를 설명합니다.
스택을 다시 생성한 후 업데이트를 확인하세요
다음 세 곳을 확인하세요.
- 실행 중인 Docker 이미지 태그
- Immich 자체 서버 버전 표시
- 마이그레이션 또는 호환성 오류를 확인하려면 컨테이너 로그를 확인하세요.
업데이트를 강제로 진행하기 위해 데이터베이스 또는 업로드 폴더를 삭제하지 마세요
볼륨을 제거하는 것은 업데이트 방법이 아니라 파괴적인 초기화입니다. 테스트된 백업이 있고 새로 설치하려는 경우가 아니라면 데이터베이스와 사진 라이브러리를 보존하세요.
FAQ
서버 태그를 변경했는데도 Immich에 2.6.1이 계속 표시되는 이유는 무엇인가요?
앱이 이전 서비스 정의를 다시 생성하고 있거나 스택이 일관되게 업데이트되지 않았을 수 있습니다. 실제 실행 중인 이미지와 패키지 소스를 확인하세요.
머신 러닝 버전이 서버 버전과 정확히 일치해야 하나요?
배포하는 Immich 릴리스/Compose 정의에 명시된 테스트된 버전을 따르세요. 각 서비스에 대해 독립적인 태그를 임의로 지정하지 마세요.
immich-server만 업데이트할 수 있나요?
기본 방법으로는 피하세요. Immich는 여러 서비스로 구성된 스택이므로 업그레이드 시 조율된 변경이 필요할 수 있습니다.
무엇을 먼저 백업해야 하나요?
PostgreSQL 데이터베이스와 미디어/업로드 저장소입니다. 주요 버전을 변경하기 전에 백업을 확인하세요.
