Calibre-Web Automated(CWA)는 기존 Calibre-Web 컨테이너를 대체할 수 있는 합리적인 최신 대안이지만, 해당 포럼 스레드만으로는 IceWhale이 실제로 App Store 패키지를 교체했다는 사실을 확인할 수 없습니다. IceWhale은 팀에서 요청 사항을 확인해 보겠다고만 답변했습니다.
지금 CWA를 사용하려는 사용자를 위해 업스트림 프로젝트는 Docker Compose를 권장하며, 기본 Calibre-Web에서 마이그레이션하는 명확한 절차도 제공합니다.
사용자가 기존 앱을 교체하려 한 이유
2026년 2월 게시글에서는 기존 Calibre-Web 패키지가 최신 Calibre 데스크톱 데이터베이스 변경 사항을 더 이상 따라가지 못한다고 주장했습니다. 이는 사용자의 판단이었으며, IceWhale은 해당 스레드에서 정확한 오류나 문제를 확인하지 않았습니다.
CWA는 업스트림에서 활발히 유지 관리되고 있습니다
현재 Calibre-Web Automated 저장소에는 활발히 개발 중인 프로젝트와 권장 Compose 배포 방식이 안내되어 있습니다.
현재 스택은 영구 저장소로 /config, /cwa-book-ingest 및 /calibre-library를 마운트하며, 기본적으로 컨테이너 포트 8083에서 웹 UI를 제공합니다.
기본 Calibre-Web에서 신중하게 마이그레이션하기
업스트림 CWA 가이드에 따르면 기존 Calibre-Web 사용자는 기존 인스턴스를 중지하고, 기존 /config를 재사용하거나 복사한 뒤, 기존 라이브러리를 CWA의 /calibre-library에 연결해야 합니다. 기존 컨테이너를 복구할 수 있도록 먼저 복사본을 만들어 두세요.
수집 디렉터리는 라이브러리가 아닙니다. CWA는 /cwa-book-ingest에 넣은 파일을 처리한 후 삭제합니다. 해당 경로를 책 라이브러리의 유일한 사본에 연결하지 마세요.
ZimaOS에서 사용자 지정 앱으로 설치하기
업스트림 Compose 파일을 시작점으로 사용하고, 예시 호스트 경로를 영구적인 ZimaOS 저장소 경로로 바꾸고, PUID/PGID와 시간대를 설정한 다음, 검토한 Compose 구성을 ZimaOS로 가져오세요.
사용자 지정 Docker 앱 가이드에서는 이 배포 모델에서 ZimaOS 측 설정을 다룹니다.
CWA를 확인하기 전에는 기존 Calibre-Web을 삭제하지 마세요
CWA를 임시로 다른 호스트 포트에서 시작하고 로그인한 다음, 사용자와 설정을 확인하고 라이브러리를 둘러보세요. 삭제해도 되는 테스트용 책을 가져온 후 컨테이너를 재시작해 보세요. 이 모든 과정을 마친 뒤에만 기존 인스턴스를 종료하세요.
결론
포럼 요청은 접수되었지만 App Store 교체로 확정된 것은 아닙니다. CWA는 Docker Compose를 통해 직접 배포할 수 있으며, 업스트림의 마이그레이션 절차를 따르면 패키지 교체를 기다리는 것보다 안전하게 전환할 수 있습니다. 먼저 기존 구성과 라이브러리를 보존하고, 기존 앱을 제거하기 전에 새 인스턴스를 테스트하세요.
