소스의 우회 방법은 2025년의 특정 Immich 패키지에는 실용적이었지만, 현재 업그레이드 안내서에 그대로 고정해서는 안 됩니다. 한 커뮤니티 사용자는 수동으로 다음을 변경했습니다. immich-server 및 immich-machine-learning 이미지 태그를 v1.134.0원 게시자는 이것이 기본 ZimaOS 시스템에서는 결국 작동했지만 테스트 VM에서는 작동하지 않았다고 말했습니다.
Immich는 이후 v3으로 변경되었으며, 현재 유지 관리되는 배포 모델은 전체 Docker Compose 스택과 IMMICH_VERSION 값을 사용합니다. 데이터베이스, 캐시, 머신 러닝 또는 API의 가정이 변경된 경우 한두 개의 서비스 태그만 업데이트하면 버전이 혼합된 스택이 생성될 수 있습니다.
2025년 소스에서는 개별 Immich 서비스 태그를 편집했습니다
커뮤니티에서는 사용자에게 서버와 머신 러닝 태그를 모두 변경하라고 안내했습니다
CogZog는 둘 다라고 말했습니다 immich-server 및 immich-machine-learning 새 태그를 사용해야 합니다. 사용자는 두 태그를 모두 변경했다고 확인했지만, 테스트 VM은 여전히 이전 버전에 머물렀습니다.
기본 ZimaOS 빌드는 결국 v1.134.0에 도달했습니다
소스에서는 데이터베이스 이미지를 수동으로 업데이트해야 한다는 규칙을 제시하지 않았습니다
beep은 데이터베이스도 더 최신의 안정적인 태그로 변경해야 하는지 물었습니다. 커뮤니티의 반응은 사실상 “문제가 없으면 고치지 말라”는 것이었습니다. 이는 의견일 뿐 Immich의 마이그레이션 정책이 아닙니다.
현재 Immich는 v3이며, 전체 Compose 업데이트 경로를 사용합니다
Immich v3.0.0은 2026년 7월에 출시되었습니다. 업스트림에서는 다음과 같이 설정하여 유지 관리되는 스택을 업데이트하라고 안내합니다. IMMICH_VERSION=v3 일반적인 Compose pull/recreate 프로세스를 실행하고, 동시에 v3의 주요 변경 사항 및 마이그레이션 참고 사항도 검토하세요.
현재 Immich v3 릴리스 지침을 참조하세요.
현재 업스트림에서는 전체 Docker Compose 번들을 권장합니다
Immich의 최신 설치 문서에서는 릴리스의 docker-compose.yml 및 .env그런 다음 위치를 설정하고 IMMICH_VERSION. PostgreSQL 데이터베이스 경로는 네트워크 공유가 아닌 지원되는 로컬 파일 시스템에 유지해야 합니다.
수동 또는 사용자 지정 배포에는 현재 Immich Compose 모델을 사용하세요.
ZimaOS 앱 스토어 패키지에서는 현재 앱 업데이트 경로 우선 사용
현재 ZimaOS 앱 스토어 2.0에는 설치된 앱 업데이트 관리 기능이 포함되어 있습니다. 스토어 패키지에서 Immich 업데이트를 제공하는 경우, 한 서비스의 태그를 개별적으로 수정하지 말고 패키지 정의를 통해 전체 다중 서비스 스택을 업데이트하세요.
주요 Immich 업그레이드 전에 백업
주요 버전 변경 전에 사진/동영상 라이브러리와 데이터베이스/애플리케이션 상태를 모두 보호하세요. 정상적인 라이브러리 디렉터리만으로는 앨범, 사용자, 메타데이터 및 애플리케이션 상태를 복구하기에 충분하지 않습니다.
혼합 버전의 Immich 스택 생성 방지
Immich는 독립적인 컨테이너 하나로 구성되지 않습니다. 애플리케이션, 머신러닝 서비스, 데이터베이스 및 기타 지원 구성 요소는 조정된 릴리스 토폴로지로 함께 테스트됩니다. 한 이미지만 업데이트하고 다른 이미지는 고정된 상태로 두면 API, 스키마 또는 시작 과정에서 호환성 문제가 발생할 수 있습니다.
해당 소스는 사용자의 실제 스택이 v1.134.0을 실행할 수 있을 만큼 잘 맞춰진 후에만 작동했으며, 임의의 태그 혼용이 안전하다는 것을 입증하지 않습니다.
PostgreSQL을 지원되는 로컬 스토리지에 유지
현재 Immich 요구 사항에 따르면 PostgreSQL 데이터 디렉터리는 로컬 파일 시스템을 사용해야 하며 네트워크 공유에 두어서는 안 됩니다. 데이터베이스 상태는 일반적으로 사진 라이브러리에 비해 작지만 사용자, 앨범, 메타데이터 및 애플리케이션 상태에 필수적입니다.
ZimaOS 패키지와 사용자 지정 Compose 스택 중 어떤 것을 설치했는지 확인하세요
Immich가 ZimaOS 앱 스토어에서 설치된 경우 스토어의 현재 업데이트 경로를 사용하고 패키지 변경 사항을 검토하세요. 직접 가져온 Compose를 사용했다면 업스트림 버전 고정, .env, 데이터베이스 경로 및 마이그레이션 단계를 확인하세요.
앱 스토어에서 수정한 내용과 수동으로 유지 관리하는 업스트림 스택을 섞으면 향후 문제 해결이 더 어려워집니다.
주요 업그레이드 사전 점검 수행
- 사진 라이브러리의 최근 백업이 있는지 확인하세요.
- 데이터베이스/애플리케이션 상태를 백업하세요.
- 현재 버전과 볼륨 매핑을 기록하세요.
- 업스트림의 주요 변경 사항을 읽으세요.
- 이미지 풀 및 마이그레이션을 수행할 수 있도록 시스템/AppData 드라이브에 충분한 여유 공간이 있는지 확인하세요.
업데이트 후 실행 중인 버전과 작업 확인
“저장 완료”에서 멈추지 마세요. Immich의 정보/시스템 페이지를 열어 실행 중인 서버 버전을 확인하고, 컨테이너 상태를 점검한 다음 업로드, 썸네일, 머신러닝 작업 및 모바일 앱 연결을 확인하세요.
소스 자체가 그 이유를 보여 줍니다. 태그를 수정해도 실행 중인 인스턴스가 실제로 즉시 업데이트된다는 의미는 아니었습니다.
롤백은 항상 태그를 이전 값으로 되돌리는 것만으로 해결되지 않습니다
주요 릴리스에서 데이터베이스 스키마나 상태가 마이그레이션된 경우 이미지 버전 다운그레이드가 지원되지 않을 수 있습니다. 이전 태그가 언제나 되돌리기 수단이라고 가정하지 말고, 업스트림의 마이그레이션/롤백 안내와 백업을 사용하세요.
Immich 업데이트 FAQ
2025년 수동 태그 방식이 소스 사용자의 주 시스템에서 작동했나요?
네, 궁극적으로는 그렇습니다. 테스트 VM에서는 동일하게 작동하지 않았습니다.
현재 Immich 사용자는 immich-server 및 machine-learning 태그만 업데이트해야 하나요?
아니요. 현재 Immich v3는 버전 및 마이그레이션 안내와 함께 완전한 Compose 스택으로 유지 관리됩니다.
소스에 IceWhale이 Immich 자동 업데이트를 약속했다는 내용이 있나요?
아니요. Zima-Giorgio는 팀에서 요청 사항을 논의할 것이라고만 말했습니다.
