Immich는 자체 서버에서 사진과 동영상을 관리할 수 있는 오픈 소스 플랫폼입니다. 이 글에서는 WSL2와 Docker Desktop을 사용해 Windows 11에 Immich를 구축하는 방법을 설명합니다. 포트 2283, 저장 위치, Docker 볼륨과 백업도 함께 다룹니다.
Immich란?
Immich는 Google 포토를 대체할 수 있는 개인정보 보호 중심 서비스입니다. 사진 보관함을 직접 관리하면서 모바일 자동 업로드, 빠른 검색, 얼굴·사물 인식과 공유 기능을 사용할 수 있습니다.
준비 사항
| 항목 | 최소 | 권장 |
|---|---|---|
| CPU | 2코어 | 4코어 |
| RAM | 6GB | 8GB |
| OS | 64비트 OS | WSL2가 설치된 Windows 11 |
- 관리자 권한이 있는 Windows 11 PC
- Windows용 Docker Desktop
- Ubuntu 배포판을 포함한 WSL2
- 사진 보관함과 데이터베이스를 저장할 충분한 공간
WSL2 활성화
- PowerShell을 관리자 권한으로 엽니다.
- 아래 명령을 실행합니다.
- 요청되면 Windows를 다시 시작합니다.
- 시작 메뉴에서 Ubuntu를 열고 초기 설정을 완료합니다.
wsl --installDocker Desktop 설치
- 공식 사이트에서 Docker Desktop을 다운로드합니다.
- 설치 중 WSL 2 백엔드를 활성화합니다.
- Settings → Resources → WSL Integration에서 Ubuntu를 켭니다.
설치 화면은 공식 Docker Desktop 문서를 확인하세요.
Immich 파일 다운로드
Ubuntu 또는 WSL 터미널을 열고 작업 폴더를 만듭니다. 아래 명령은 현재 Immich 릴리스의 Docker Compose 파일과 환경 변수 예제 파일을 다운로드합니다.
mkdir -p ~/immich-app
cd ~/immich-appwget -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에서 UPLOAD_LOCATION과 DB_DATA_LOCATION을 확인합니다. UPLOAD_LOCATION은 사진과 동영상, DB_DATA_LOCATION은 PostgreSQL 데이터베이스를 저장합니다. 용량이 충분한 드라이브를 선택하고 두 위치를 모두 백업하세요.
Docker 볼륨 사용
Compose 설정에서 이름이 있는 Docker 볼륨을 사용할 수도 있습니다. 이동은 편리하지만 볼륨을 별도로 백업하는 계획이 필요합니다.
Immich 시작
docker compose up -d실행 중인 컨테이너를 확인합니다.
docker pshttp://localhost:2283을 엽니다. 같은 네트워크의 다른 기기에서는 http://서버-IP:2283을 사용하고 Windows 방화벽에서 포트를 허용하세요.
초기 설정과 모바일 백업
- 웹 화면에서 첫 번째 계정을 만듭니다.
- Immich 모바일 앱을 설치합니다.
- 서버 URL을 입력하고 로그인합니다.
- 필요한 앨범의 자동 백업을 활성화합니다.
백업과 업데이트
Immich 자체는 백업이 아닙니다. 업로드 디렉터리와 데이터베이스를 다른 디스크나 저장 서비스에 복사하고 복원을 정기적으로 테스트하세요. 업데이트 전에는 릴리스 노트를 읽고 .env 파일을 보관합니다.
문제 해결
- 페이지가 열리지 않으면 Docker Desktop 실행 여부와 포트 2283을 확인합니다.
- 서비스가 반복 재시작되면 docker ps와 컨테이너 로그를 확인합니다.
- 디스크가 가득 차면 스택을 중지한 뒤 데이터를 이동하고 모든 경로를 일관되게 수정합니다.
정리
WSL2, Docker Desktop과 최신 Immich Compose 파일을 사용하면 Windows 11에서 개인 사진 보관함을 운영할 수 있습니다. 저장 경로, 포트 2283과 검증된 백업 계획을 기록해 두세요.
면책 사항: 이 글은 정보 제공을 위한 것입니다. Immich, Docker Desktop, Windows와 설정은 변경될 수 있습니다. 저장소나 컨테이너를 변경하기 전에 데이터를 백업하고, 사용 중인 버전에 맞는 공식 문서에서 명령을 확인하세요.
댓글