커뮤니티 솔루션

ZimaOS에서 Immich 사진 저장소를 NAS 또는 더 큰 디스크로 이동

A March–April 2025 Immich storage thread where an IceWhale reply pointed users to Docker path mapping and a community member documented the exact host-side volume changes needed to move database, model cache, uploads, and selected media paths to larger storage.

Immich는 많은 저장 공간을 사용할 수 있으므로, 업로드 파일과 데이터베이스, 머신러닝 캐시를 ZimaOS 시스템 디스크에 그대로 두는 것은 사진 라이브러리가 커질수록 적합하지 않은 경우가 많습니다.

이 2025년 스레드에서는 호스트 측 볼륨 매핑을 편집하여 Immich를 다른 ZimaOS 저장 위치로 옮기는 수동 방법을 설명합니다. 현재 ZimaOS는 저장 위치와 마이그레이션을 보다 직접적으로 제어할 수 있는 기능도 제공하므로, 수동 스크린샷은 컨테이너 경로가 서로 어떻게 연결되는지 설명하는 자료로 참고하는 것이 좋습니다.

볼륨을 변경하기 전에 Immich 설정 열기

저장 볼륨을 변경하기 전 설정 옵션이 강조 표시된 ZimaOS Immich 앱 메뉴
커뮤니티에서 사용한 작업 흐름은 Files에서 폴더를 무작정 옮기는 대신, 설치된 Immich 애플리케이션의 설정을 먼저 여는 방식으로 시작했습니다.

컨테이너 경로가 아닌 데이터베이스 호스트 경로 이동

호스트 경로가 /media/Main에 설정되고 PostgreSQL 컨테이너 경로는 변경되지 않은 Immich 데이터베이스 볼륨 매핑
커뮤니티에서 작동한 설정은 데이터베이스 매핑에서 ZimaOS 측 경로만 변경하고 PostgreSQL 컨테이너의 대상 경로는 그대로 유지했습니다.

호스트 경로와 컨테이너 경로를 구분하는 것은 매우 중요합니다. 애플리케이션은 컨테이너 내부에서 특정 경로를 사용하도록 설계되어 있으므로, 스택을 정확히 이해하지 못한 상태에서 양쪽 경로를 모두 변경하면 시작에 실패하거나 기존 데이터가 사라진 것처럼 보일 수 있습니다.

머신러닝 캐시도 더 큰 저장 공간에 저장 가능

ZimaOS의 더 큰 /media 경로에 모델 캐시가 저장된 Immich 머신러닝 볼륨 매핑
커뮤니티 예시에서는 호스트 측 모델 캐시 폴더를 옮기고 컨테이너가 예상하는 캐시 대상 경로는 그대로 유지했습니다.

immich-server 탭은 더 주의해서 다뤄야 함

업로드 경로와 선택한 미디어 폴더가 /media 아래 저장 공간으로 변경된 Immich 서버 볼륨 매핑
원문 작성자는 일부 immich-server 매핑은 변경해야 하지만, 다른 매핑은 애플리케이션이 요구하는 대로 정확히 유지해야 한다고 강조했습니다.

원문 게시물은 커뮤니티에서 테스트한 방법일 뿐, 모든 Immich 버전에 대한 IceWhale의 보증이 아닙니다. Immich 스택은 시간이 지나면서 크게 변경되었으므로, 현재 패키지를 비교하지 않고 최신 패키지에 2025년의 동일한 볼륨 표를 그대로 적용하지 마세요.

현재 ZimaOS는 더 직접적인 저장소 작업 흐름 제공

현재 ZimaOS Immich 안내에서는 저장 파일 위치를 변경하는 방법을 제공하며, Data Migration 또는 제어된 수동 복사를 통해 Immich 데이터를 다른 디스크로 옮기는 방법도 설명합니다.

현재 설치 환경에서는 2025년 스크린샷을 보고 볼륨 매핑을 다시 구성하기 전에 현재 제공되는 Immich 저장소 및 마이그레이션 제어 기능부터 사용하세요.

파일을 수동으로 옮길 경우 먼저 Immich 중지

현재 ZimaOS 안내에서는 Immich의 Gallery 데이터를 수동으로 복사하기 전에 Immich를 비활성화한 다음, 관련 호스트 측 경로를 업데이트하고 애플리케이션을 다시 시작하도록 안내합니다. 이동 중 쓰기 작업을 중지하면 사진 라이브러리가 일관되지 않은 상태로 복사될 위험을 줄일 수 있습니다.

ZimaOS의 Immich 저장소 FAQ

Immich 사진을 ZimaOS-HD 대신 더 큰 디스크에 저장할 수 있나요?

예. 2025년 커뮤니티 예시와 현재 ZimaOS Immich 작업 흐름 모두 다른 저장 위치를 사용할 수 있도록 지원합니다.

컨테이너 측 PostgreSQL 경로를 변경해야 하나요?

원문 작업 흐름에서는 변경하지 않습니다. 호스트 측 저장 경로만 변경하고 애플리케이션 컨테이너 경로는 PostgreSQL이 예상하는 위치로 유지했습니다.

2025년의 네 탭을 모두 정확히 따라야 하나요?

아니요. 해당 내용은 컨테이너 레이아웃을 보여 주는 과거의 예시로 참고하세요. 변경하기 전에 현재 Immich 패키지와 비교해야 합니다.

이제 기본 제공 마이그레이션 옵션이 있나요?

현재 ZimaOS Immich 안내에서는 Immich 데이터를 위한 Data Migration과 제어된 수동 이동 방법을 모두 설명합니다.