커뮤니티 솔루션

ZimaOS 시스템 SSD에서 HDD 또는 RAID로 Immich 사진 이동: 라이브러리 마이그레이션 사용 또는 볼륨 경로 업데이트

An August 2025 thread where a new ZimaOS user installed Immich on a 128 GB system SSD but wanted phone photos stored on a separate 500 GB HDD. They tried the old Apps > User database migration and received a Something wrong error. A community reply linked a dedicated Immich storage guide. Current IceWhale documentation now explicitly documents Immich Library migration and a manual Gallery-copy/volume-path method.

목표가 “Immich는 SSD에 설치된 상태로 유지하되 사진은 HDD/RAID에 저장”하는 것이라면 모든 앱 카테고리를 옮길 필요가 없습니다. 현재 ZimaOS 문서에는 Immich 전용 저장소 워크플로가 있습니다. 사용자 라이브러리(예: Gallery/Media)에는 데이터 마이그레이션 → 라이브러리 마이그레이션을 사용하거나, Immich를 중지하고 Gallery를 새 저장소로 복사한 다음 immich-server 호스트 볼륨 경로를 업데이트하고 앱을 다시 시작하면 됩니다.

2025년에 해당 사용자는 이전의 앱 → 사용자 데이터베이스 마이그레이션 화면을 사용했으며, 일반적인 “문제가 발생했습니다” 오류를 받았습니다. 이후 ZimaOS의 저장소 및 마이그레이션 도구가 재설계되었으므로 해당 이전 화면을 현재의 확정적인 Immich 절차로 사용해서는 안 됩니다.

시스템 SSD의 앱 데이터, 앱 이미지 및 사용자 데이터베이스 위치를 보여 주는 이전 ZimaOS 앱 마이그레이션 페이지
원래 사용자는 “사용자 데이터베이스”에 집중했지만, 현재 ZimaOS에서는 라이브러리 마이그레이션을 더 명확하게 분리합니다.
시스템 드라이브에서 sda1로 사용자 데이터베이스를 옮기는 중 문제가 발생했음을 보여 주는 이전 ZimaOS 마이그레이션 화면
대상 HDD가 비어 있고 Immich 라이브러리에 테스트 이미지가 한 장만 있었는데도 이전 마이그레이션 시도는 실패했습니다.

현재 라이브러리 마이그레이션으로 사용자 사진 라이브러리 옮기기

현재 IceWhale 문서에 따르면 설정 → 데이터 마이그레이션에서 Gallery, Documents, Media 및 Backup과 같은 라이브러리 카테고리를 다른 저장소 위치로 옮길 수 있습니다.

ZimaOS Gallery 아래에 있는 Immich 휴대폰 사진 라이브러리에는 이것이 현재의 관리형 경로입니다.

현재 Immich 사진 및 저장소 가이드를 사용하세요.

수동 마이그레이션을 수행하려면 먼저 Immich를 중지해야 합니다

현재 공식 수동 워크플로는 개념적으로 다음과 같습니다.

  1. Immich를 비활성화하거나 중지합니다.
  2. Gallery 폴더를 대상 저장소로 복사합니다.
  3. immich-server 볼륨을 편집하여 호스트 경로가 새 Gallery를 가리키도록 합니다.
  4. Immich를 다시 시작합니다.
  5. 기존 사진과 새 업로드를 확인합니다.

업로드 또는 인덱싱이 진행 중인 동안 실행 중인 사진 데이터베이스 아래의 파일을 옮기지 마세요.

앱 데이터와 사진 라이브러리는 서로 다른 저장소 선택 사항입니다

Immich의 애플리케이션 및 데이터베이스 상태와 사용자 사진 라이브러리는 증가 속도가 크게 다를 수 있습니다. SSD에는 용량이 적은 앱 런타임 및 설정을 유지하고, 대용량 사진 및 동영상 자산은 RAID 또는 HDD에 저장해도 괜찮습니다.

Immich 라이브러리에 더 많은 용량이 필요하다는 이유만으로 Docker 이미지나 모든 앱의 AppData를 옮기지 마세요.

Immich 데이터베이스는 별도로 보호하세요

자산 라이브러리를 옮긴다고 해서 데이터베이스 백업이 대체되는 것은 아닙니다. Immich 데이터베이스에는 사용자, 앨범, 메타데이터 및 파일 기록 상태가 포함됩니다. 완전한 재해 복구가 중요하다면 호환되는 데이터베이스 백업과 자산 파일을 함께 보관하세요.

나중에 HDD를 RAID로 구성할 예정이라면 지금 다음 이동을 계획하세요

원래 사용자는 테스트 HDD를 RAID 어레이로 교체할 계획이었습니다. 안정적인 최상위 저장소 경로와 현재의 ZimaOS 데이터 마이그레이션 워크플로를 사용하면 여러 임시 폴더에 Immich 볼륨을 흩어 놓는 것보다 향후 이동이 쉬워집니다.

기존 사진과 새 업로드를 모두 확인하세요

마이그레이션 후 기존 이미지 몇 장을 열고 휴대폰에서 새 사진 한 장을 업로드하세요. 새 파일이 시스템 SSD를 계속 몰래 사용하지 않고 대상 HDD/RAID에 저장되는지 확인합니다.

테스트 중 작은 시스템 SSD를 가득 채우지 마세요

휴대폰 백업, 썸네일 및 애플리케이션 캐시가 쌓이면 128GB 시스템 디스크가 빠르게 가득 찰 수 있습니다. 현재 ZimaOS에서는 시스템 드라이브가 한계에 도달하기 전에 앱 데이터 위치를 확인하고 카테고리를 더 큰 저장소로 마이그레이션할 수 있습니다.

Immich 저장소 위치 FAQ

Immich 사진을 옮기기 위해 모든 AppData를 옮겨야 하나요?

아니요. 현재 ZimaOS는 라이브러리별 마이그레이션과 Immich 볼륨 경로 설정 방법을 제공합니다.

원래 사용자의 이전 사용자 데이터베이스 마이그레이션은 성공했나요?

아니요. 해당 시도는 일반적인 “문제가 발생했습니다” 오류로 종료되었습니다.

앱은 SSD에 유지하면서 사진은 HDD/RAID에 저장할 수 있나요?

예. 영구 사진 라이브러리 호스트 경로가 원하는 저장소에 매핑되어 있고 데이터베이스 및 설정이 적절히 백업되어 있다면 가능합니다.