Immich를 외부 PostgreSQL 서비스에 연결할 수는 있지만, 그렇다고 업그레이드가 자동으로 안전해지는 것은 아닙니다. 데이터베이스 버전, 확장, 권한, 백업 및 롤백에 대한 책임이 기본 스택 외부로 옮겨집니다.
외부 데이터베이스를 성능 설정이 아니라 고급 호환성 경계로 취급하세요. Immich 또는 PostgreSQL을 업그레이드하기 전에 실행할 Immich 릴리스의 요구 사항을 확인하고, 외부 서버가 필요한 확장과 권한을 제공할 수 있는지 확인한 뒤, 복원 가능한 백업을 만드세요. 또한 실패를 일으킨 구성 요소를 파악할 수 있도록 업그레이드 계층을 한 번에 하나씩 변경하세요.
외부 데이터베이스 계약부터 시작하세요
데이터베이스 엔드포인트, 데이터베이스 이름, 서비스 계정, TLS 모드, PostgreSQL 메이저 버전, 설치된 확장의 이름과 버전, 그리고 해당 확장을 업그레이드할 수 있는 담당자를 기록하세요. 컨테이너를 다시 만들 때 다른 서버나 데이터베이스에 몰래 다시 연결되는 일이 없도록 Immich 배포 정의와 함께 이 기록을 보관하세요.
기존 PostgreSQL 서버를 사용하는 것도 가능하지만, Immich에서 기본적으로 권장하는 설정은 아닙니다. 최신 릴리스에서 독립형 데이터베이스 경로를 사용하려면 pgvector와 VectorChord가 필요합니다. Immich는 PostgreSQL 14~19, pgvector >=0.7 및 <0.9, VectorChord >=0.3 및 <2.0에서 작동하는 것으로 알려져 있습니다. 이 범위는 변경될 수 있으므로 업그레이드할 때마다 다시 확인하세요.
전환 전에 권한을 계획하세요. Immich는 일반적으로 슈퍼유저 권한이 있는 데이터베이스 역할을 요구합니다. 해당 권한 없이 실행하는 것은 업데이트 중 수동 개입이 필요할 수 있는 고급 경로이며, 현재 자동화된 데이터베이스 백업에도 슈퍼유저 권한이 필요합니다. 외부 제공업체가 이러한 요구 사항을 충족할 수 없다면 프로덕션 데이터를 이전하기 전에 중단하세요.
변경 전에 PostgreSQL 및 확장 호환성 확인
현재 및 대상 PostgreSQL 버전과 Immich가 의존하는 모든 확장을 함께 확인하세요. PostgreSQL 메이저 버전을 업그레이드하면 대상 메이저 버전에 맞춰 빌드된 확장 바이너리가 필요할 수 있습니다. 한편 Immich 업그레이드에는 PostgreSQL 자체가 계속 실행되더라도 더 최신 버전의 확장이나 마이그레이션 동작이 필요할 수 있습니다.
확장 패키지 파일과 SQL 확장 상태는 PostgreSQL 업그레이드에 따라 자동으로 유지된다고 가정하지 말고, 데이터베이스와 함께 계획적으로 이전해야 합니다. 데이터베이스 메이저 버전이나 Immich에 필요한 확장 패키지를 변경하기 전에 PostgreSQL 확장 업그레이드 종속성을 확인하세요.
외부 제공업체에서 필요한 확장을 설치 또는 업그레이드할 수 없거나, 필요한 경우 공유 preload 설정을 변경할 수 없거나, 마이그레이션에 필요한 권한을 부여할 수 없다면 Immich를 업데이트하기 전에 중단하세요. 일반 쿼리를 처리할 수 있는 데이터베이스라도 다음 애플리케이션 마이그레이션에는 적합하지 않을 수 있습니다.
데이터베이스 메이저 버전 업그레이드는 Immich 업그레이드와 분리하세요
전체 절차를 미리 연습해 본 경우가 아니라면 PostgreSQL 메이저 업그레이드, 확장 기능 업그레이드, Immich 애플리케이션 업그레이드를 한 번의 유지관리 작업으로 묶지 마세요. 여러 호환성 경계가 한꺼번에 바뀌면 시작 실패만으로는 어느 계층에서 문제가 발생했는지 알 수 없습니다.
PostgreSQL 마이너 업데이트와 메이저 버전 업그레이드는 서로 다른 유지관리 작업이며, 메이저 업그레이드에서는 타사 확장 기능을 포함한 대상 환경을 먼저 준비해야 합니다. 가능하면 PostgreSQL 메이저 버전 업그레이드와 Immich 애플리케이션 업그레이드를 별도로 진행하세요. 그러면 시작에 실패해도 조사할 변경 사항이 하나로 명확해집니다.
홈 서버에서 가장 위험이 낮은 순서는 대개 백업 생성, 복원 확인, 한 계층 업데이트, 검증 실행, 다음 단계 진행입니다. Immich 릴리스에서 데이터베이스 변경이 필요하다면 일반적인 PostgreSQL 업그레이드 절차를 적용하지 말고 해당 릴리스에서 지정한 순서를 따르세요.
데이터베이스와 미디어 모두를 포함하는 롤백 경로를 보존하세요
외부 데이터베이스를 사용하면 Immich 상태가 PostgreSQL과 미디어 라이브러리에 나뉘어 있다는 사실을 간과하기 쉽습니다. 데이터베이스 일관성을 보장하는 방법으로 데이터베이스를 백업하고, 스키마나 에셋 메타데이터를 변경할 수 있는 마이그레이션 전에 동일한 복구 시점의 관련 미디어 및 구성 상태도 보존하세요.
복원 시점에는 데이터베이스 상태, 애플리케이션 파일, 구성, 업로드 파일이 서로 일치해야 합니다. PostgreSQL이 시작되는지만 보는 것이 아니라 일관성 있는 데이터베이스 컨테이너 백업을 승인 기준으로 삼으세요.
애플리케이션 마이그레이션이 부분적으로 성공했을 때 양쪽에 어떤 일이 일어나는지 알기 전까지는 롤백 준비가 완료됐다고 판단하지 마세요. 새 상태를 유일한 정상 작동 사본에 덮어쓰지 않고 복구할 수 있도록 기존 애플리케이션 버전, 배포 정의, 데이터베이스 백업, 미디어 상태를 충분히 오래 보관하세요.
데이터베이스 연결만이 아니라 애플리케이션으로 업그레이드를 검증하세요
변경 후 PostgreSQL이 의도한 Immich 역할을 받아들이는지, 필요한 확장 기능이 예상 버전으로 설치되어 있는지, 반복적인 데이터베이스 오류 없이 Immich 마이그레이션이 완료되는지 확인하세요. TCP 연결 성공이나 `SELECT 1`은 연결성을 입증할 뿐, 애플리케이션과의 호환성을 입증하지는 않습니다.
그런 다음 Immich를 평소처럼 사용하세요. 기존 앨범을 불러오고, 대표적인 사진과 동영상을 열어 보고, 검색하고, 해당되는 경우 사용자나 공유 설정을 확인한 뒤, 삭제해도 되는 파일 하나를 업로드하세요. 이 작업을 하는 동안 애플리케이션과 데이터베이스 로그를 살펴 누락된 확장 기능, 권한 오류, 마이그레이션 실패 또는 반복적인 재시도가 있는지 확인하세요.
애플리케이션이 해당 검사를 통과한 뒤에만 일반적인 백업 보존 정책을 다시 적용하고 롤백용 사본을 제거하세요. 외부 데이터베이스를 사용하면 Immich를 정기적으로 업그레이드할 때마다 안정적으로 사전 연습할 수 없는 확장 기능이나 권한을 수동으로 처리해야 한다면, 기본 전용 데이터베이스 수명 주기를 따르는 편이 운영상 더 안전합니다.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



