언레이드에 immich on Unraid 사진 서버를 최적화 쾌적화 설치 및 설정하는 방법

언레이드에 immich 서버를 설치하는 과정입니다. Unraid의 APPS에서 시놀로지의 패키지처럼 앱으로 간편하게 설치하실 수도 있습니다만,
본문에서는 immich는 APP 단독 설치보다는 Compose를 통한 Docker 설치로 진행하겠습니다.

이유는 아래처럼 immich 서버, machine learning, postgres, redis를 서로 한 번에 연동 시킬 수 있습니다. 그럼으로써 immich 기능에 강력함, 쾌적함을 더하게 됩니다.
설치 과정이 다소 APPS 보다 다소 복잡해 보일 수 있겠지만 어렵지 않으니 천천히 따라오시기 바랍니다.

그럼 시작합니다.

■ 1단계

목차 안내

Unraid > Docker 를 클릭합니다.

■ 2단계

화면 좌측 맨 하단에 보시면, Compose 항목이 있고 그 밑에 아래와 같은 버튼이 보일겁니다. ADD NEW STACK 버튼을 클릭합니다.

■ 3단계

스택 이름을 immich 으로 입력하고 OK를 누릅니다.

■ 4단계

톱니바퀴를 마우스로 클릭합니다.

■ 5단계

EDIT STACK을 클릭합니다.

■ 6단계

COMPOSE FILE을 클릭합니다.

■ 7단계

아래 코드를 복사해서 붙여넣습니다.

name: immich

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    volumes:
      - ${UPLOAD_LOCATION}:/data
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - .env
    ports:
      - '2283:2283'
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: false

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
    volumes:
      # 🔹 머신러닝 컨테이너가 모델/캐시를 저장하는 임시·보조 공간 ( SSD 또는 NVMe 권장 )
      - /mnt/cache/immich_cache:/cache
    env_file:
      - .env
    restart: always
    healthcheck:
      disable: false

  redis:
    container_name: immich_redis
    image: docker.io/valkey/valkey:8@sha256:81db6d39e1bba3b3ff32bd3a1b19a6d69690f94a3954ec131277b9a26b95b3aa
    healthcheck:
      test: redis-cli ping || exit 1
    restart: always

  database:
    container_name: immich_postgres
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:bcf63357191b76a916ae5eb93464d65c07511da41e3bf7a8416db519b40b1c23
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
      POSTGRES_INITDB_ARGS: '--data-checksums'
    volumes:
      - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
    shm_size: 128mb
    restart: always

위 스크립트의 중간 쯤에 immich-machine-learning: 의 볼륨 쪽을 보시면 아래 경로가 있습니다.

volumes:
      # 🔹 머신러닝 컨테이너가 모델/캐시를 저장하는 임시·보조 공간 ( SSD 또는 NVMe 권장 )
      - /mnt/cache/immich_cache:/cache

사진 원본 저장 위치를 바꾸는 설정은 아니고, 얼굴 인식·스마트 검색 등에 쓰이는 모델·캐시를 빠른 저장소(SSD 또는 NVMe)에 두는 설정이라고 보시면 됩니다.

■ 8단계

웹 브라우저에서 새 웹페이지를 띄워 다시 Unraid 다시 접속하고 터미널을 실행합니다.

■ 9단계

터미널에 아래 스크립트를 그대로 복사 붙여넣기 합니다. cache 공간에 immich_cache 폴더가 생성 됩니다.

mkdir -p /mnt/cache/immich_cache
chmod -R 777 /mnt/cache/immich_cache

※ 만약 SSD나 NVMe가 없다면 7단계의 /mnt/cache/immich_cache:/cache 이 부분을 /mnt/user/immich_cache:/cache 이렇게 수정하세요. ( cache → user )
그러면 immich-machine-learning의 저장소가 HDD (Array)로 지정됩니다.