요구 사항
Immich에 대한 하드웨어 및 소프트웨어 요구 사항:
하드웨어
- OS: Linux 또는 *nix 운영 체제(Ubuntu, Debian 등)를 권장합니다.
- 비-Linux OS는 Docker 사용 경험이 좋지 않아 권장하지 않습니다.
비-Linux OS에서 설정 또는 문제 해결을 지원할 수 있는 능력이 크게 줄어듭니다.
그래도 비-Linux OS를 사용하려면 아래의 방법으로 설정할 수 있습니다:
- Windows: Windows에서 Docker Desktop 또는 WSL 2.
- macOS: Mac에서 Docker Desktop.
- Immich는 완전한 가상 머신에서 실행되는 가상화 환경에서 잘 작동합니다. LXC 컨테이너 내의 Docker 사용은 권장하지 않음이지만 고급 사용자는 가능할 수 있습니다. 문제가 발생하면 지원 가능한 VM 배포로 전환할 것을 권장합니다.
- 비-Linux OS는 Docker 사용 경험이 좋지 않아 권장하지 않습니다.
비-Linux OS에서 설정 또는 문제 해결을 지원할 수 있는 능력이 크게 줄어듭니다.
그래도 비-Linux OS를 사용하려면 아래의 방법으로 설정할 수 있습니다:
- RAM: 최소 4GB, 권장 6GB.
- CPU: 최소 2코어, 권장 4코어.
- 스토리지: 사용자/그룹 소유 권한을 지원하는 Unix 호환 파일 시스템(EXT4, ZFS, APFS 등)을 권장합니다.
- 썸네일 및 변환된 비디오 생성은 평균적으로 사진 라이브러리 크기를 10-20% 증가시킬 수 있습니다.
Postgres 데이터베이스에 안정적인 연결과 성능은 Immich를 원활하게 사용하는 데 중요합니다.
Postgres 데이터베이스 파일은 일반적으로 크기가 1-3 GB입니다.
따라서 DB_DATA_LOCATION은 이상적으로는 로컬 SSD 스토리지를 사용해야 하며, 네트워크 공유를 사용하지 않아야 합니다.
추가로 Docker 리소스 제한이 사용되는 경우 Postgres 데이터베이스는 최소 2GB의 RAM이 필요합니다.
Windows 사용자는 Unix와 호환되지 않는 파일 시스템에서 문제가 발생할 수 있으며 아래에 더 자세히 나와 있습니다.
소프트웨어
Immich는 Docker와 Docker Compose 플러그인을 필요로 합니다:
- Docker Engine: 이 CLI 변형은 Linux 서버(또는 WSL2를 통한 Windows)를 위해 설계되었습니다.
- Docker Desktop: 이 GUI 변형은 Linux에서는 권장하지 않음이지만, Windows 또는 macOS에서 사용 가능합니다.
Compose 플러그인은 설치 가이드를 따르면 Docker Engine과 Desktop 모두에 설치됩니다; 별도로 설치할 수도 있습니다.
Immich는 docker compose 명령어를 필요로 합니다; 유사한 이름의 docker-compose는 폐기됨 상태이며 더 이상 Immich에서 지원되지 않습니다.
Windows 사용자를 위한 특별 요구 사항
Windows 시스템의 데이터베이스 스토리지
Immich Postgres 데이터베이스(DB_DATA_LOCATION)는 사용자/그룹 소유 권한을 지원하는 파일 시스템(EXT2/3/4, ZFS, APFS, BTRFS, XFS 등)에 위치해야 합니다.
NTFS 또는 ex/FAT/32로 포맷된 파일 시스템에서는 작동하지 않습니다.
WSL(Windows Subsystem for Linux)에서 마운트된 호스트 디렉토리(일반적으로 /mnt 아래 사용)에서는 작동하지 않습니다.
이 문제가 발생하면 바인드 마운트를 다음과 같이 Docker 볼륨으로 변경할 수 있습니다:
.env에 다음 변경 사항을 적용하세요:
- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata
docker-compose.yml의 하단에 다음 줄을 추가하세요:
volumes:
model-cache:
+ pgdata: