ZimaOS에 사진 백업 앱 Immich 설치하는 방법 1 : 최신 버전과 SSD 저장 경로 설정
지난 글에서는 Zima Client를 이용해 윈도우 PC의 작업 폴더를 ZimaOS 저장소로 백업하는 방법을 알아봤습니다. 이번에는 스마트폰에 저장된 사진과 동영상을 NAS로 백업하고 관리할 수 있는 Immich를 설치해 보겠습니다.
Immich는 개인 서버에 설치해 사용하는 오픈소스 사진 관리 프로그램입니다. 스마트폰 사진과 동영상 자동 백업을 비롯해 앨범 관리, 얼굴 인식, 위치 기반 검색과 같은 기능을 제공합니다.
ZimaOS 앱스토어에서도 Immich를 설치할 수 있지만, 앱스토어에 등록된 버전이 현재 배포 중인 정식 버전보다 낮을 수 있습니다. 기본 설정으로 설치하면 사진이 ZimaOS 시스템 저장소에 보관될 수 있으므로 설치 전에 버전과 사진 저장 경로를 확인하는 것이 좋습니다.
이번 글에서는 Immich의 최신 정식 버전을 확인한 뒤 ZimaOS 앱스토어의 맞춤 설치 기능을 이용해 버전을 변경하고, 사진 저장 경로를 데이터용 SSD로 지정하는 과정을 알아보겠습니다.
Immich는 사진 관리와 백업에 유용하지만 중요한 사진을 보관하는 유일한 저장소로 사용해서는 안 됩니다. NAS 저장장치 고장에 대비해 외장 저장장치나 다른 NAS, 클라우드에도 별도의 복사본을 보관하는 것이 안전합니다.
Immich 최신 정식 버전 확인
ZimaOS 앱스토어에서 설치를 시작하기 전에 현재 배포 중인 Immich의 최신 정식 버전을 확인합니다.
1. Immich 최신 버전 검색
구글 검색창에 immich 최신버전을 입력하거나 Immich 공식 GitHub의 Releases 페이지에 접속합니다.
글 작성 시점에 확인한 최신 정식 버전은 v3.3.5였으며, 개발 중인 프리뷰 버전으로는 v3.4.0-rc.1이 공개되어 있었습니다.
RC가 붙은 버전은 정식 출시 전 테스트 단계이므로 사진을 장기간 보관하는 서버에는 최신 정식 버전을 사용하는 것이 안전합니다. 이 글에서는 v3.3.5를 기준으로 설치했습니다.
Immich 버전은 계속 업데이트되므로 실제 설치 시점에는 공식 GitHub Releases 페이지에서 최신 정식 버전을 다시 확인하시기 바랍니다.
ZimaOS 앱스토어에서 Immich 선택
최신 정식 버전을 확인했다면 ZimaOS 관리 화면에서 Immich 설치를 시작합니다.
2. ZimaOS 앱스토어 실행
웹브라우저에서 ZimaOS 관리 화면에 접속합니다. 메인 대시보드의 앱 목록에서 파란색 앱스토어 아이콘을 클릭합니다.
3. 앱스토어에서 Immich 선택
앱스토어가 열리면 왼쪽 메뉴에서 ALL을 선택하거나 검색창에 Immich를 입력합니다. 목록에서 무지개색 바람개비 모양의 아이콘과 함께 표시된 Immich를 찾아 클릭합니다.
4. Immich 맞춤 설치 실행
Immich 상세 화면 오른쪽 위에는 맞춤 설치와 설치 버튼이 표시됩니다.
일반 설치 버튼을 누르면 앱스토어 템플릿에 등록된 버전과 기본 저장 경로가 그대로 적용됩니다. 제가 확인한 템플릿에는 v2.7.2 버전이 지정되어 있었기 때문에 최신 정식 버전과 저장 위치를 직접 설정하기 위해 맞춤 설치를 선택했습니다.
앱스토어 템플릿은 이후 업데이트될 수 있으므로 설치 화면에 표시된 실제 버전을 먼저 확인하시기 바랍니다. 이미 최신 정식 버전이 적용되어 있다면 버전 태그를 임의로 변경할 필요가 없습니다.
Immich 서버 이미지 버전 변경
맞춤 설치 화면에서는 Immich를 구성하는 컨테이너와 저장 경로를 직접 확인할 수 있습니다.
5. immich-server Tag 변경
Immich 사용자 지정 설치 창의 서비스 구성에서 먼저 immich-server 항목을 선택합니다.
기존 Tag 입력란에 v2.7.2 또는 해시값이 포함된 이전 버전이 표시되어 있다면 해당 내용을 지우고 앞에서 확인한 최신 정식 버전인 v3.3.5를 입력합니다.
이어서 서비스 목록에서 immich-machine-learning 항목을 선택하고 이 컨테이너의 Tag도 동일하게 v3.3.5로 변경합니다.
다음 두 컨테이너의 Tag 값이 서로 같아야 합니다.
immich-server:v3.3.5immich-machine-learning:v3.3.5
서버 컨테이너만 최신 버전으로 변경하고 머신러닝 컨테이너를 이전 버전으로 남겨두면 기능이 정상적으로 작동하지 않거나 호환성 문제가 발생할 수 있습니다.
## Immich 사진 저장 경로 설정
스마트폰에서 백업되는 사진과 동영상은 시간이 지날수록 용량이 계속 증가합니다. 사진을 ZimaOS 시스템 드라이브에 저장하면 운영체제가 사용할 공간이 부족해질 수 있으므로 별도의 데이터 저장용 SSD를 사용하는 것이 좋습니다.
6. SSD-Storage에 Immich 폴더 지정
맞춤 설치 화면을 아래로 내려 볼륨 > 마운트 항목을 찾습니다.
컨테이너 경로가 /usr/src/app/upload로 설정된 항목에서 호스트 경로 오른쪽에 있는 폴더 모양 아이콘을 클릭합니다.
폴더 선택 창이 열리면 데이터 저장용 드라이브를 선택합니다. 그 다음 AppData폴더로 이동해서 Gallery 폴더를 생성 후 해당 폴더로 이동합니다.
SSD-Storage(우리집 데이터 저장용 드라이브) > AppData > Gallery
Gallery 폴더 안에서 사진 라이브러리를 보관할 immich 폴더를 생성하기 위해서 아래쪽의 + 새 폴더를 클릭해 immich라는 이름으로 새 폴더를 만든 뒤 선택합니다.
폴더 선택을 완료한 다음 오른쪽 아래의 확인 버튼을 클릭합니다.
7. 마운트 경로 확인 후 설치
폴더 선택 창이 닫히면 마운트 항목에 입력된 경로를 확인합니다.
제 환경에서는 다음과 같이 설정했습니다.
호스트 경로:
/media/SSD-Storage/AppData/Gallery/immich컨테이너 경로:
/usr/src/app/upload
호스트 경로는 ZimaOS에서 실제 사진과 동영상이 저장되는 위치이며, 컨테이너 경로는 Immich가 업로드 파일을 인식하는 내부 위치입니다. 그래서 컨테이너 경로는 수정할 필요가 없고, 호스트 경로만 수정을 해주시면 됩니다.
두 경로가 올바르게 연결되어 있는지 확인한 뒤 오른쪽 아래의 파란색 설치 버튼을 클릭합니다.
Immich 설치 진행 상태 확인
설치 버튼을 누르면 ZimaOS가 필요한 도커 이미지를 내려받고 Immich를 구성하는 컨테이너를 생성합니다.
8. 비동기 설치 진행률 확인
설치가 시작되면 화면 위쪽에 앱이 비동기적으로 설치되고 있습니다라는 알림이 나타납니다.
Immich 상세 화면 오른쪽 위에서는 원형 진행 표시를 통해 현재 설치 진행률을 확인할 수 있습니다.
Immich는 서버뿐만 아니라 머신러닝과 데이터베이스 등 여러 서비스를 함께 사용하므로 인터넷 속도와 미니 PC 성능에 따라 설치 시간이 오래 걸릴 수 있습니다. 진행률이 완료될 때까지 기다립니다.
설치 도중에는 ZimaOS 전원을 끄거나 인터넷 연결을 해제하지 않는 것이 좋습니다.
9. ZimaOS 대시보드에서 설치 완료 확인
설치가 완료되면 ZimaOS 메인 대시보드의 앱 목록에 Immich 아이콘이 추가됩니다.
설치 직후에는 도커 컨테이너 초기화와 머신러닝 서비스 준비 작업이 진행되면서 CPU와 메모리 사용량이 일시적으로 높아질 수 있습니다. 초기 작업이 끝나면 시스템 사용량은 점차 낮아집니다.
대시보드에서 Immich 아이콘을 클릭해 초기 설정 화면이 정상적으로 열리는지 확인합니다.
아이콘이 등록됐더라도 초기 설정 화면이 바로 열리지 않는다면 잠시 기다린 뒤 다시 실행합니다. 계속 연결되지 않는다면 Immich 컨테이너의 실행 상태와 설치 과정에서 입력한 Tag 값을 확인해야 합니다.
Immich 설치 전 알아둘 점
Immich는 스마트폰 사진과 동영상을 개인 NAS에 보관하는 데 유용하지만, Immich 서버 한 곳에만 사진을 저장하는 것은 안전한 백업 방법이 아닙니다.
데이터용 SSD가 고장 나거나 파일 시스템에 문제가 생기면 Immich에 보관한 사진도 함께 손실될 수 있습니다. 중요한 사진은 다음과 같이 다른 저장매체에도 추가로 보관하는 것이 좋습니다.
스마트폰에 남아 있는 원본 사진
ZimaOS의 Immich 사진 라이브러리
외장 저장장치 또는 클라우드에 보관한 추가 복사본
Immich를 업데이트하기 전에는 공식 릴리스 안내에서 주요 변경 사항을 확인하고, 사진 라이브러리와 데이터베이스를 별도로 백업하는 것이 안전합니다.
ZimaOS Immich 설치를 마치며
지금까지 ZimaOS 앱스토어의 맞춤 설치 기능을 이용해 Immich 서버 이미지 버전을 변경하고, 스마트폰 사진이 저장될 경로를 데이터용 SSD로 지정하는 방법을 알아봤습니다.
기본 설치는 간편하지만, 사진과 동영상이 계속 쌓이는 서비스를 장기간 운영하려면 설치 전에 버전과 저장 경로를 직접 확인하는 것이 좋습니다. 특히 사진 저장 경로를 시스템 드라이브와 분리하면 용량 부족으로 ZimaOS 운영에 문제가 생길 가능성을 줄일 수 있습니다.
다음 글에서는 ZimaOS에 Immich 설치하는 방법 2탄으로, 설치한 Immich를 처음 실행하고 관리자 계정을 생성하는 과정과 기본적인 초기 설정 방법을 알아보겠습니다.
댓글