파일 사용자 정의 위치

이 가이드는 Docker의 볼륨 마운트를 사용하여 생성된 파일 및 원본 파일을 서로 다른 위치에 저장하는 방법을 설명합니다.

백업

특히 profile/을 사용하는 경우 자동 백업 도구로 새 백업 경로를 백업하려면 가이드를 따른 후 백업 설정을 업데이트해야 한다는 점을 기억하는 것이 중요합니다.

.env 파일에서 사용하려는 경로를 정의합니다. 모든 값을 정의할 필요는 없으며, UPLOAD_LOCATION은 기본적으로 파일이 저장되는 기본 폴더가 되고 다른 경로는 별도의 오버라이드 역할을 합니다.

.env
# 지원되는 모든 환경 변수에 대한 문서는 [여기](/docs/install/environment-variables)에서 확인할 수 있습니다.

# 업로드된 파일, 썸네일 및 트랜스코딩된 비디오 파일이 저장되는 사용자 정의 위치
- UPLOAD_LOCATION=./library
+ UPLOAD_LOCATION=/custom/path/immich/immich_files
+ THUMB_LOCATION=/custom/path/immich/thumbs
+ ENCODED_VIDEO_LOCATION=/custom/path/immich/encoded-video
+ PROFILE_LOCATION=/custom/path/immich/profile
+ BACKUP_LOCATION=/custom/path/immich/backups
...

파일의 위치를 정의한 후에 docker-compose.yml 파일을 수정하고 새로운 변수를 immich-server 컨테이너에 추가합니다. 이 경로는 컨테이너 내에서 마운트되는 위치이므로 변경하지 마십시오.

docker-compose.yml
services:
  immich-server:
      volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
+     - ${THUMB_LOCATION}:/usr/src/app/upload/thumbs
+     - ${ENCODED_VIDEO_LOCATION}:/usr/src/app/upload/encoded-video
+     - ${PROFILE_LOCATION}:/usr/src/app/upload/profile
+     - ${BACKUP_LOCATION}:/usr/src/app/upload/backups
      - /etc/localtime:/etc/localtime:ro

이 변경을 적용한 후 Immich가 필요한 모든 파일을 찾을 수 있도록 파일을 새 폴더로 이동해야 합니다. 중요한 항목을 아직 업로드하지 않았다면 데이터베이스 폴더를 삭제하여 Immich를 완전히 초기화할 수도 있습니다. 변경 사항을 적용하려면 Immich를 재시작하십시오:

docker compose up -d

참고

Docker 바인드 마운트의 기본 속성으로 인해 동일한 장치에 있는 경우 upload/ 및 library/ 폴더를 별도의 바인드 마운트로 마운트하는 것은 권장되지 않습니다. 이 때문에 HDD 또는 네트워크 스토리지(NAS)를 /usr/src/app/upload에 마운트하고, 접근하려는 폴더를 그 폴더 아래에 마운트합니다.

thumbs/ 폴더에는 타임라인에 표시되는 작은 썸네일과 이미지를 클릭했을 때 표시되는 더 큰 미리보기 이미지가 모두 포함되어 있어 분리할 수 없습니다.

Immich 서버의 스토리지 메트릭은 UPLOAD_LOCATION에서 사용할 수 있는 저장소를 추적하므로 관리자는 저장 공간이 부족하지 않도록 모니터링 시스템을 설정해야 합니다. profile/ 폴더는 일반적으로 1MB 미만으로 매우 작습니다.