Immich 설치 방법: Docker Compose로 구글 포토 대체 서버 만들기

Immich는 구글 포토를 대신해 내 서버에 사진·동영상을 자동 백업하고 얼굴별로 정리해 주는 오픈소스 앱이며, 공식 문서 기준으로 Docker Compose 파일 두 개(docker-compose.yml, .env)를 내려받아 docker compose up -d 한 줄로 설치할 수 있다.1 아래에 필요한 사양, 설치 순서, 모바일 앱 백업 설정, 업그레이드와 백업 주의점을 정리했다. 버전이 빠르게 바뀌는 프로젝트라 compose 파일을 이 글에 옮기지 않고, 항상 최신 릴리스 파일을 받는 방식으로 적는다.

왜 구글 포토 대신 Immich를 찾을까?

구글은 2021년 6월 1일부터 새로 올리는 고화질 사진·동영상도 계정의 무료 15GB 저장공간(Drive, Gmail과 공유)에 포함하기 시작했다.2 이후 용량 부담 때문에 자체 서버 백업 대안을 찾는 사람이 늘었다. Immich는 그 대안 중 하나로, 저장 위치와 데이터를 직접 통제할 수 있다는 점이 장점이다. 반면 서버 운영, 업그레이드, 백업을 스스로 책임져야 한다는 점은 단점이다.

Immich 웹 화면 예시
Immich 웹 인터페이스. 타임라인, 앨범, 인물 분류를 제공한다.

어떤 기능이 있나?

  • 모바일 자동 백업: 앱을 열거나 재개할 때(포그라운드)와 주기적으로 백그라운드에서 선택한 앨범의 새 항목을 올린다. 기본값은 Wi-Fi 연결 시에만 업로드이며, 충전 중에만 실행하는 옵션은 안드로이드에서 제공된다.3 iOS는 백그라운드 앱 새로고침을 켜야 하고, 실행 시점은 OS가 결정한다.3
  • 얼굴 인식: 인물 병합, 인물 숨기기, 생년월일 설정(촬영 당시 나이 표시), 대표 사진 변경을 지원한다.4
  • 다양한 클라이언트: 웹, 안드로이드, iOS 앱을 제공한다. 앱은 앱스토어, 구글 플레이, GitHub 릴리스(APK) 등에서 받을 수 있다.5

서버 사양은 얼마나 필요한가?

항목 최소 권장
RAM 6GB 8GB
CPU 코어 2 4
OS 64비트 리눅스(Ubuntu, Debian 등) 권장
DB 저장소 로컬 SSD, 네트워크 공유 불가

RAM이 4GB뿐이면 머신러닝 기능(얼굴 인식 등)을 끄고 운영할 수 있다. 썸네일과 변환된 동영상 때문에 라이브러리 용량은 원본보다 대략 10~20% 늘어난다.6 LXC 안에서 Docker를 돌리는 구성은 권장되지 않는다.6

Docker Compose로 설치하려면?

Docker Engine과 Compose 플러그인이 먼저 설치돼 있어야 한다. 배포판 기본 패키지는 버전이 맞지 않아 오류가 날 수 있으니 Docker 공식 저장소 설치를 권한다.1 이후 순서는 다음과 같다.

  1. 작업 디렉터리를 만든다: mkdir immich-app && cd immich-app
  2. 최신 릴리스 파일을 받는다.
    wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
    wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
  3. .env를 수정한다.
  4. 실행한다: docker compose up -d
docker compose up -d로 Immich 컨테이너를 실행하는 화면
compose 파일이 있는 디렉터리에서 실행한다.

접속 포트는 공식 compose 파일에 정의되어 있으며 이전 버전에서는 2283을 쓰는 예가 흔했다. 실제 값은 내려받은 파일에서 확인한다.

.env에서 꼭 바꿀 값은?

변수 설명
UPLOAD_LOCATION 사진·동영상이 저장될 경로. 여유 공간이 충분한 디스크로 지정
DB_DATA_LOCATION DB 파일 경로. 네트워크 공유는 지원되지 않음
TZ 주석을 풀고 시간대 지정(한국은 Asia/Seoul)
IMMICH_VERSION 기본값 또는 v2.1.0 같은 특정 버전으로 고정
DB_PASSWORD 기본값 postgres에서 변경. 영문 대소문자와 숫자만 사용

위 항목은 공식 설치 안내에 따른다.1 비밀번호에 특수문자를 넣으면 Docker 파싱 문제가 생길 수 있다. 또한 start_interval 오류가 나면 Docker Engine 25 이상이 필요하다.1 과거 글의 compose 예시에는 immich-microservices나 pgvecto-rs 이미지가 있었지만 구조가 바뀌었으므로, 옛 파일을 복사하지 말고 반드시 최신 릴리스 파일을 쓴다.

업그레이드와 백업은 어떻게 하나?

업그레이드 전에 릴리스 노트에서 호환성이 깨지는 변경(breaking change)을 확인하고, .env의 버전을 수정한 뒤 docker compose pull && docker compose up -d를 실행한다. 이전 버전으로의 다운그레이드는 지원되지 않는다.7

백업에서 가장 중요한 점은 DB 덤프가 메타데이터만 담는다는 것이다. 자동 덤프는 UPLOAD_LOCATION/backups에 매일 새벽 2시, 최근 14개가 유지되지만, 사진 원본은 UPLOAD_LOCATION을 따로 백업해야 한다. 공식 문서는 3-2-1 백업 전략을 권장한다.8 서버를 멈출 수 없으면 DB를 먼저, 파일을 나중에 백업해야 DB가 존재하지 않는 파일을 가리키는 상태를 피할 수 있다.8

중지·삭제는 어떻게 하나?

같은 디렉터리에서 docker compose stop은 중지, docker compose down은 컨테이너 제거다. down만으로는 UPLOAD_LOCATION과 DB 경로의 데이터가 지워지지 않지만, 해당 디렉터리를 직접 삭제하면 사진이 사라지므로 백업 후 진행한다. 시작 전 체크리스트는 다음과 같다.

  • RAM 6GB 이상, 로컬 SSD에 DB 배치
  • .env의 비밀번호 변경, 시간대 지정
  • 사진 원본 경로의 별도 백업 대책 마련
  1. Immich Docs, Docker Compose [Recommended] — https://docs.immich.app/install/docker-compose
  2. Google, Storage changes coming to Google Photos — https://blog.google/products/photos/storage-changes/
  3. Immich Docs, Mobile Backup — https://docs.immich.app/features/mobile-backup
  4. Immich Docs, Facial Recognition — https://docs.immich.app/features/facial-recognition
  5. Immich Docs, Mobile App — https://docs.immich.app/features/mobile-app
  6. Immich Docs, Requirements — https://docs.immich.app/install/requirements
  7. Immich Docs, Upgrading — https://docs.immich.app/install/upgrading
  8. Immich Docs, Backup and Restore — https://docs.immich.app/administration/backup-and-restore

댓글은 닫혔습니다.