Immich는 구글 포토를 대신해 내 서버에 사진·동영상을 자동 백업하고 얼굴별로 정리해 주는 오픈소스 앱이며, 공식 문서 기준으로 Docker Compose 파일 두 개(docker-compose.yml, .env)를 내려받아 docker compose up -d 한 줄로 설치할 수 있다.1 아래에 필요한 사양, 설치 순서, 모바일 앱 백업 설정, 업그레이드와 백업 주의점을 정리했다. 버전이 빠르게 바뀌는 프로젝트라 compose 파일을 이 글에 옮기지 않고, 항상 최신 릴리스 파일을 받는 방식으로 적는다.
왜 구글 포토 대신 Immich를 찾을까?
구글은 2021년 6월 1일부터 새로 올리는 고화질 사진·동영상도 계정의 무료 15GB 저장공간(Drive, Gmail과 공유)에 포함하기 시작했다.2 이후 용량 부담 때문에 자체 서버 백업 대안을 찾는 사람이 늘었다. 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 이후 순서는 다음과 같다.
- 작업 디렉터리를 만든다:
mkdir immich-app && cd immich-app - 최신 릴리스 파일을 받는다.
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 .env를 수정한다.- 실행한다:
docker compose up -d

접속 포트는 공식 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의 비밀번호 변경, 시간대 지정- 사진 원본 경로의 별도 백업 대책 마련
- Immich Docs, Docker Compose [Recommended] — https://docs.immich.app/install/docker-compose
- Google, Storage changes coming to Google Photos — https://blog.google/products/photos/storage-changes/
- Immich Docs, Mobile Backup — https://docs.immich.app/features/mobile-backup
- Immich Docs, Facial Recognition — https://docs.immich.app/features/facial-recognition
- Immich Docs, Mobile App — https://docs.immich.app/features/mobile-app
- Immich Docs, Requirements — https://docs.immich.app/install/requirements
- Immich Docs, Upgrading — https://docs.immich.app/install/upgrading
- Immich Docs, Backup and Restore — https://docs.immich.app/administration/backup-and-restore
댓글은 닫혔습니다.