커뮤니티 솔루션

ZimaOS에서 잘못 구성된 Nextcloud 앱 완전 재설치: 컨테이너와 올바른 AppData만 제거

A January 2026 thread where Nextcloud remained misconfigured after uninstall/reinstall because persistent configuration remained. Portainer container cleanup did not remove that state. A community reply told the user to uninstall the App Store container and manually remove the Nextcloud AppData folder; the original poster replied that it worked.

소스에서 해결된 이유는 서로 다른 두 가지, 즉 Nextcloud 컨테이너영구 AppData를 분리했기 때문입니다. 컨테이너를 제거하고 다시 생성해도 다음 설치에서 Nextcloud가 상속받는 구성은 초기화되지 않았습니다. 기존 AppData까지 제거한 후 원 게시자는 새로 설치한 환경이 정상적으로 작동한다고 확인했습니다.

그렇다고 현재 사용자가 AppData 폴더를 무작정 삭제해야 한다는 뜻은 아닙니다. Nextcloud AppData에는 패키지 구성에 따라 구성, 데이터베이스 상태, 키 및 애플리케이션 데이터가 포함될 수 있습니다. 중요한 데이터는 백업하고, 현재 호스트 볼륨 매핑을 확인한 다음, 완전히 새로 시작하려는 것이 명확한 경우에만 확인된 Nextcloud 구성 경로를 삭제하세요.

컨테이너를 다시 설치해도 Nextcloud가 초기화되지 않은 이유

Docker 컨테이너는 필요에 따라 폐기할 수 있는 런타임 인스턴스입니다. ZimaOS는 구성 정보가 업그레이드와 컨테이너 재생성 후에도 유지되도록 영구 호스트 폴더를 컨테이너에 연결합니다.

따라서 동일한 패키지를 다시 설치하면 새 컨테이너가 생성되더라도, 즉시 동일한 잘못된 구성을 다시 읽을 수 있습니다.

Portainer가 앱을 완전히 정리하지 못한 이유

소스의 사용자는 Portainer를 사용했습니다. Portainer에서 Docker 컨테이너를 제거해도 바인드 마운트된 모든 호스트 디렉터리가 자동으로 삭제되지는 않습니다. AppData 상태는 컨테이너 수명 주기와 무관하게 남아 있었습니다.

소스에서 확인된 복구 방법은 컨테이너 제거와 AppData 정리였습니다

커뮤니티에서 제시한 순서는 다음과 같습니다.

  1. ZimaOS 앱 스토어에서 Nextcloud를 제거합니다.
  2. 영구 AppData 폴더를 확인합니다.
  3. 필요할 수 있는 데이터는 백업합니다.
  4. 완전히 새로 설치하려는 경우 문제가 있는 AppData를 제거합니다.
  5. Nextcloud를 다시 설치합니다.

원 게시자는 “정상적으로 작동했다”고 답했으며, 이는 해당 절차가 그 특정 구성 문제를 해결했음을 확인해 줍니다.

일반 파일 UI에서는 AppData에 쓰기 권한이 없을 수 있습니다

커뮤니티 답변에 따르면 소스 환경의 AppData는 시스템 또는 root 소유였기 때문에 일반 UI 사용자가 삭제할 수 없었습니다. 그렇다고 chmod -R 777을 광범위하게 실행하거나 전체 AppData 트리의 소유권을 변경해도 된다는 뜻은 아닙니다.

가능한 경우 현재 지원되는 앱 데이터 또는 제거 기능을 사용하거나, 정확한 앱 폴더에만 범위를 제한한 관리자 작업을 수행하세요.

현재 ZimaOS는 컨테이너와 영구 호스트 경로를 명확히 구분합니다

IceWhale의 현재 앱 저장소 문서에서는 앱 데이터, 미디어 및 캐시가 저장되는 위치를 설명하고, 사용자가 호스트와 컨테이너 간 볼륨 매핑을 확인할 수 있도록 합니다.

현재 ZimaOS 앱 저장소 모델을 사용하세요.

Nextcloud는 여러 컨테이너로 구성될 수 있습니다

일부 Nextcloud 패키지는 별도의 데이터베이스, Redis 또는 AIO 관리 컨테이너를 포함하거나 이에 의존합니다. 여러 컨테이너로 배포된 환경을 문제 해결 중이라면, 무엇이든 삭제하기 전에 모든 영구 데이터베이스 및 구성 경로를 확인하세요.

Nextcloud 폴더 하나를 삭제한다고 해서 외부 PostgreSQL/MariaDB 데이터베이스까지 자동으로 초기화된다고 생각하지 마세요.

삭제 작업은 그 영향을 명확히 확인한 후 진행하세요

기존 Nextcloud 인스턴스에 필요한 파일, 사용자, 공유 항목, 암호화 키 또는 데이터베이스 상태가 있다면 정리하기 전에 복사하거나 내보내세요. “새로 설치”와 “기존 인스턴스 복구”는 서로 반대되는 목표입니다.

Nextcloud 완전 재설치 FAQ

제거 후 다시 설치하기만 해도 소스의 문제가 해결되었나요?

아니요. 영구 AppData에 잘못된 구성이 남아 있었습니다.

AppData를 제거하니 소스의 문제가 해결되었나요?

예. 원 게시자가 정리 작업이 정상적으로 완료되었다고 확인했습니다.

ZimaOS의 전체 AppData 디렉터리를 삭제해야 하나요?

아니요. 중요한 데이터를 백업한 후 확인된 앱별 경로만 제거하세요.