Stirling PDF가 ZimaOS 홈 화면에 “앱 설치 중”으로 계속 표시된다면, 먼저 Docker 컨테이너가 실제로 존재하고 실행 중인지 확인하세요. 설치가 멈춘 카드는 프런트엔드 또는 앱 관리 상태 문제일 수 있지만, 컨테이너가 반복적으로 재시작된다면 실제 배포 오류를 의미합니다. 이 두 문제를 서로 다른 장애로 구분해 처리하세요.
원본 스레드에서는 검증된 해결 방법에 도달하지 못했습니다. 재설치로도 상태가 초기화되지 않았고, ZimaOS를 완전히 재시작해도 원래 사용자에게는 도움이 되지 않았습니다. 따라서 재부팅이 해결책이라고 단정하기보다 컨테이너 상태, 로그, 앱 스토어 메타데이터, 현재 패키지 동작을 진단하는 것이 안전합니다.
1단계: Stirling PDF가 실행 중인지 확인
ZimaOS 호스트 터미널에서 다음을 실행하세요.
docker ps -a --format 'table {.Names} {.Image} {.Status}' | grep -i stirlingStirling 컨테이너가 실행 중이라면, 게시된 웹 UI 포트에 직접 접속해 테스트하세요. 직접 IP와 포트로 정상 작동한다면 애플리케이션은 정상이며, 멈춘 카드는 UI 또는 관리 상태 문제일 가능성이 큽니다.
2단계: 컨테이너 로그 확인
docker logs --tail 200 <stirling-container-name>포트 충돌, 권한 오류, 잘못된 환경 변수 또는 재시작 반복이 있는지 확인하세요. 현재 컨테이너가 실패하는 원인을 파악하기 전에는 반복해서 앱을 제거하지 마세요.
3단계: ZimaOS 대시보드 강제 새로고침
브라우저의 비공개 창을 사용하거나 로컬 ZimaOS 주소의 캐시된 사이트 데이터를 삭제하세요. 새 세션에서 설치 카드가 사라진다면 백엔드는 이미 정상일 수 있습니다.
4단계: 앱 스토어와 Docker 상태를 함께 확인
UI에는 “설치 중”이라고 표시되지만 Docker에 Stirling 컨테이너가 없다면 앱 관리 작업이 오래된 상태로 남아 있을 수 있습니다. Docker에 계속 재시작되는 컨테이너가 있다면 프런트엔드 상태가 실제로 완료되지 않은 배포를 반영하는 것입니다.
최신 Stirling PDF Docker 설정 사용
현재 Stirling PDF 문서에서는 ZimaOS에 특화된 호스트 수정 없이 공식 이미지와 영구 설정 볼륨을 사용합니다.
앱 정의를 다시 구성할 때는 Stirling PDF Docker 가이드를 기준으로 삼으세요.
카드를 없애기 위해 영구 데이터를 삭제하지 마세요
Stirling PDF가 이미 설정 또는 사용자 데이터를 생성했다면 AppData를 삭제할 경우 단순한 설치 상태 문제로 인해 데이터가 손실될 수 있습니다. 수동으로 Docker를 정리하기 전에 연결된 볼륨을 백업하세요.
수동으로 Docker를 제거해도 되는 경우
UI에서 명백히 실패한 고아 컨테이너를 ZimaOS가 제거하지 못한다면, 고급 사용자는 이미지, 포트, 볼륨 매핑을 기록한 후 해당 컨테이너만 제거할 수 있습니다. 관련 없는 이미지, 네트워크 또는 볼륨은 삭제하지 마세요.
정리한 후 앱 스토어를 새로 고치고 최신 패키지 또는 업스트림 Compose 정의를 사용해 다시 설치하세요.
현재 ZimaOS 버전 확인
원본 사례는 2025년 중반에 발생했습니다. 이후 최신 ZimaOS에는 앱 스토어, Docker 시작, 웹 UI 포트 및 YAML 호환성과 관련된 광범위한 수정 사항이 적용되었습니다. 과거의 설치 멈춤 증상을 현재 제품 버그로 판단하기 전에 최신 안정 버전으로 업데이트하세요.
더 व्यापक한 컨테이너 모델은 Docker 문제 해결 가이드에서 확인할 수 있습니다.
설치 작업이 아직 활동을 생성하는지 확인
카드가 같은 진행률에서 무기한 멈춰 있다면 몇 분 동안 Docker 이미지 가져오기, 컨테이너 생성 및 네트워크 활동을 비교해 보세요. 실제로 이미지를 다운로드 중이라면 이미지 또는 레이어 상태가 변경되어야 하지만, 오래된 프런트엔드 작업은 아무 일도 일어나지 않아도 그대로 멈춰 있을 수 있습니다.
재설치 전에 포트 충돌 확인
Stirling PDF는 일반적으로 웹 서비스를 노출합니다. 패키지가 선택한 호스트 포트를 이미 다른 서비스가 사용 중이면 이미지는 성공적으로 내려받아도 컨테이너가 시작되지 않을 수 있습니다. 설치 버튼을 반복해서 누르기보다 컨테이너 로그와 현재 포트 바인딩을 확인하세요.
영구 경로에 쓰기 권한이 있는지 확인
이미지를 다운로드한 후에도 설정 또는 작업 디렉터리가 컨테이너가 쓸 수 없는 호스트 폴더에 연결되어 있으면 컨테이너가 실패할 수 있습니다. /DATA 전체에 광범위한 권한을 부여하기보다 호스트 경로가 존재하고 컨테이너에 적절한 소유권이 설정되어 있는지 확인하세요.
FAQ
ZimaOS를 재부팅하면 멈춘 Stirling PDF 설치가 해결되나요?
일시적인 상태를 초기화할 수는 있지만, 원래 사용자의 사례에서는 문제가 해결되지 않았습니다. 먼저 실제 Docker 컨테이너와 로그를 확인하세요.
대시보드에는 설치 중이라고 표시되지만 Stirling PDF가 열리면 어떻게 하나요?
애플리케이션은 정상일 가능성이 높으며, 문제는 ZimaOS 프런트엔드 또는 앱 관리 상태에 있을 수 있습니다.
Stirling PDF AppData를 삭제해야 하나요?
아니요. 설치 카드를 없애기 위한 목적만으로 삭제하지 마세요. 데이터를 삭제하는 정리를 하기 전에 영구 볼륨을 백업하세요.
현재 공식 Stirling 이미지를 사용해야 하나요?
예. 앱을 다시 구성한다면 오래된 매니페스트가 아니라 최신 업스트림 Docker 문서를 따르세요.
