메인 콘텐츠로 바로가기

TrueNAS [Community]

참고

이 문서는 커뮤니티의 기여로 작성되었으며 Immich 팀에서 공식적으로 지원하지는 않지만, 편의를 위해 여기에 포함되었습니다.

커뮤니티 지원은 Discord 서버의 전용 채널에서 받을 수 있습니다.

앱 문제는 해당 Github 저장소에 보고해주세요.

Immich는 TrueNAS 커뮤니티 에디션에서 커뮤니티 트레인 애플리케이션을 통해 쉽게 설치할 수 있습니다. 시스템에서 애플리케이션을 이전에 구성한 적이 없다면 TrueNAS 애플리케이션 리소스를 검토하십시오.

TrueNAS 커뮤니티 에디션은 Immich의 설치 및 업데이트를 손쉽게 할 수 있게 하지만, 계정을 설정하고 라이브러리에 접근하려면 Immich 웹 포털 및 모바일 앱을 사용해야 합니다.

첫 번째 단계

TrueNAS 커뮤니티 에디션에서 Immich 앱을 설치하면, 초기 구성을 완료하고 Immich 웹 포털을 시작합니다. 업데이트가 가능한 경우, TrueNAS에서 알림을 제공하고 쉽게 업데이트할 수 있습니다.

TrueNAS에서 Immich 앱을 설치하기 전에 설치 중 설정할 내용을 미리 확인하려면 환경 변수 문서를 검토하세요. 애플리케이션 배포 후 언제든 환경 변수를 설정할 수 있습니다.

스토리지 데이터셋 설정

앱 설치를 시작하기 전에 데이터셋 생성을 생성하여 설치 중 스토리지 구성 섹션에서 사용할 데이터를 준비하세요. Immich는 library, upload, thumbs, profile, video, backups, pgData 등 7개의 데이터셋이 필요합니다. 이를 /mnt/tank/immich/library, /mnt/tank/immich/upload 같이 하나의 부모와 7개의 자식 데이터셋 구조로 구성할 수 있습니다.

Immich App Widget
권한

pgData 데이터셋은 postgres가 시작되기 위해 사용자 netdata(UID 999)가 소유해야 합니다. 나머지 데이터셋은 사용자 root(UID 0) 또는 사용자 root(UID 0)가 포함된 그룹의 소유여야 Immich에서 필요한 권한을 가질 수 있습니다.

library 데이터셋이 ACL을 사용하는 경우, 스토리지 템플릿을 사용하려면 ACL 모드를 Passthrough로 설정하고 네트워크 공유에 대해 데이터셋이 구성되어 있어야 합니다(ACL 유형이 SMB/NFSv4로 설정된 경우).

Immich 애플리케이션 설치

Immich 애플리케이션을 설치하려면 으로 이동한 다음 앱 검색을 클릭하고 검색 창에 Immich를 입력하거나 아래로 스크롤하여 Immich 애플리케이션 위젯을 찾습니다.

Immich App Widget

위젯을 클릭하여 Immich 애플리케이션 세부정보 화면으로 이동합니다.



  • Application Info 위젯에서 Edit을 클릭하여 Edit Immich 화면을 엽니다.
  • 변경하고 싶은 설정을 수정합니다.
    • 수정 화면의 설정은 설치 화면의 설정과 동일합니다.
  • 페이지 맨 아래에서 Update를 클릭하여 변경 사항을 저장합니다.
    • TrueNAS는 업데이트된 설정으로 Immich 컨테이너를 자동으로 업데이트, 다시 생성 및 재배포합니다.

환경 변수

환경 변수를 설정하려면 Additional Environment Variables 옵션에서 Add를 클릭하고 NameValue를 입력합니다.

환경 변수
정보

일부 환경 변수는 TrueNAS Community Edition 앱에서는 사용할 수 없습니다. 이는 주로 Edit Immich 화면 GUI 옵션에서 설정할 수 있기 때문입니다.

예: IMMICH_VERSION, UPLOAD_LOCATION, DB_DATA_LOCATION, TZ, IMMICH_LOG_LEVEL, DB_PASSWORD, REDIS_PASSWORD.

앱 업데이트

위험

일반적인 업데이트 지침을 반드시 읽으십시오.

업데이트가 가능해지면 TrueNAS는 알림을 제공하고 쉽게 업데이트를 진행할 수 있습니다. 앱을 최신 버전으로 업데이트하려면:

  • Installed Applications 화면으로 이동하여 설치된 애플리케이션 목록에서 Immich를 선택합니다.
  • Installed Applications 화면의 Application Info 위젯에서 Update를 클릭합니다.
  • 업데이트 창이 열리며 몇 가지 옵션을 제공합니다.
    • 이미지 업데이트를 선택할 수도 있습니다.
    • 변경 로그를 확인할 수 있습니다.
  • Upgrade를 클릭하여 프로세스를 시작하고 진행 상황을 보여주는 카운터 대화 상자를 엽니다.
    • 완료되면 업데이트 배지와 버튼이 사라지고 설치 화면의 애플리케이션 업데이트 상태가 Update Available에서 Up to date로 변경됩니다.