CasaOS와 ZimaOS는 서로 다른 운영 체제이므로 두 시스템 간 이동은 인플레이스 업그레이드가 아니라 마이그레이션입니다. 파일, 표준 앱 데이터 및 많은 Docker Compose 구성을 전송할 수 있지만, 시스템 사용자, 네트워크 설정, 저장소 마운트, 공유 및 고도로 사용자 지정된 컨테이너는 수동으로 다시 만들어야 할 수 있습니다.
커뮤니티 질문이 처음 게시된 후 답변도 변경되었습니다. 2025년 7월 공식 답변에서는 LAN을 통해 파일을 복사하고 앱을 수동으로 재설치하는 방법을 설명했습니다. 2025년 9월 IceWhale은 마이그레이션 가이드를 발표했습니다. 2026년 9월에 업데이트된 현재 가이드에는 여러 CasaOS App Store 컨테이너와 해당 데이터를 전송하는 CTOZ 도구가 추가되었습니다.
CasaOS에서 ZimaOS로의 전환은 인플레이스 업그레이드가 아니라 마이그레이션입니다.
인플레이스 업그레이드라면 시스템 구성을 자동으로 유지하면서 CasaOS를 교체하게 됩니다. 그러나 이는 ZimaOS 팀이 설명한 방식이 아닙니다. ZimaOS를 설치하면 다른 운영 체제 환경이 생성되므로, 안전한 계획은 목록 작성, 백업, 설치, 마이그레이션, 검증을 수행한 후에야 기존 환경을 폐기하는 것입니다.
개인 파일, 애플리케이션 데이터, Compose 정의, 자격 증명 및 구성 메모를 검증된 저장소에 복사하기 전에는 CasaOS 시스템의 유일한 사본을 덮어쓰지 마세요.
시작하기 전에 앱 경로와 설정 기록
첫 번째 공식 답변에서는 각 앱의 설정 패널을 열고 기존 폴더 경로를 기록할 것을 권장했습니다. 자동 마이그레이션 도구를 사용할 수 있는 경우에도 이는 여전히 유용합니다. 컨테이너가 성공적으로 시작되더라도 잘못된 데이터 디렉터리를 가리킬 수 있기 때문입니다.
각 앱에 대해 다음을 기록하세요.
- 컨테이너 이미지 및 버전
- 호스트 및 컨테이너 볼륨 경로
- 포트 및 네트워크 모드
- 환경 변수와 사용자/그룹 ID
- AppData, 데이터베이스, 미디어 및 구성 폴더
- 수동으로 생성한 Docker 네트워크 또는 장치
CasaOS와 ZimaOS를 동시에 실행할 수 있을 때의 마이그레이션
가장 간단한 방법은 CasaOS 소스와 ZimaOS 대상 시스템을 동일한 LAN에서 사용할 수 있도록 하는 것입니다. 필요한 CasaOS 폴더를 SMB로 공유하고, ZimaOS Files에서 해당 공유를 마운트한 다음 데이터를 대상 저장소로 복사하거나 마이그레이션하세요.
CasaOS 앱 스토어를 통해 설치한 앱의 경우, 현재 CasaOS-ZimaOS 마이그레이션 가이드에서는 커뮤니티에서 개발한 CTOZ 도구를 권장합니다. CTOZ는 CasaOS AppData 디렉터리와 해당 Docker Compose YAML을 전송한 다음, 지원되는 앱을 ZimaOS에 다시 설치할 수 있습니다.
CTOZ가 마이그레이션하는 항목
- 지원되는 CasaOS 앱과 연결된 AppData.
- 컨테이너를 재생성하는 데 사용되는 Docker Compose YAML.
- 매핑된 폴더에 포함된 표준 앱 데이터 및 구성.
CTOZ가 자동으로 마이그레이션하지 않는 항목
- CasaOS 사용자 및 시스템 수준 설정.
- 네트워크 구성, 저장소 마운트 및 공유 구성.
- CasaOS 앱 스토어 외부에 배포된 비표준 컨테이너.
- AppData 또는 Compose 파일에 반영되지 않은 사용자 지정 호스트 변경 사항.
서버가 하나뿐인 경우의 마이그레이션
2025년 스레드에서는 가장 까다로운 토폴로지를 강조했습니다. 베어 메탈 재설치 중에는 동일한 서버에서 CasaOS와 ZimaOS를 나란히 실행할 수 없습니다. 팀은 먼저 파일을 Windows PC에 복사한 뒤 ZimaOS 설치 후 다시 복원하고, 각 애플리케이션과 해당 데이터를 개별적으로 처리할 것을 제안했습니다.
현재 가이드에서는 오프라인 또는 독립 실행형 환경을 위한 CTOZ 내보내기/가져오기도 설명합니다. 이를 통해 컨테이너를 수동으로 재구성하는 작업을 줄일 수 있지만, 별도의 백업 저장소가 필요하지 않다는 의미는 아닙니다. CasaOS를 교체하기 전에 지원되는 앱 자료를 내보내고, 개인 파일 및 시스템 설정에 대한 별도 기록과 함께 Windows PC, 외장 디스크, NAS 또는 다른 확인된 대상에 복사합니다.
권장 CasaOS-ZimaOS 마이그레이션 순서
- 목록 작성: 파일, 공유, 앱, 볼륨, 포트, 자격 증명, 데이터베이스, 사용자 및 사용자 지정 컨테이너를 나열합니다.
- 백업: CasaOS 시스템 디스크 외부에 하나 이상의 확인된 복사본을 만듭니다. 데이터베이스는 파일 복사 외에 앱별 내보내기가 필요할 수 있습니다.
- 지원되는 앱 내보내기: 해당하는 경우 현재 CTOZ 워크플로를 사용하고 Docker Compose YAML을 보관합니다.
- ZimaOS 설치: 다른 장치에서 백업을 열 수 있는지 확인한 후에만 새로 설치를 수행합니다.
- 파일 복원: 개인 파일과 앱 데이터를 ZimaOS의 지정된 저장 위치에 복사합니다.
- 앱 가져오기 또는 재설치: CTOZ 또는 ZimaOS의 수동 Compose 가져오기를 사용한 다음, 필요한 경우 포트와 볼륨 경로를 수정합니다.
- 시스템 설정 재생성: ZimaOS에서 사용자, 공유, 네트워크, 마운트 및 권한을 구성합니다.
- 확인: 모든 앱을 열어 데이터를 확인하고, 쓰기 및 권한을 테스트하며, 백업을 삭제하기 전에 원격 액세스를 확인합니다.
앱이 자동으로 다시 설치되지 않는 경우
현재 ZimaOS 문서에 따르면 자동 컨테이너 설치가 실패하더라도 CTOZ는 AppData를 전송합니다. 대상 폴더에 같은 이름이 이미 있으면 도구가 해당 폴더를 덮어쓰는 대신 숫자를 추가할 수 있습니다. 그런 다음 내보낸 Compose YAML을 ZimaOS 앱 스토어를 통해 수동으로 가져올 수 있습니다.
자동 마이그레이션 후에는 앱 설정을 확인하고 볼륨 경로가 전송된 폴더를 가리키는지 검증하세요. 컨테이너가 실행 중이라는 사실만으로 데이터베이스, 미디어 라이브러리 또는 구성이 올바르게 복원되었다고 볼 수는 없습니다.
CLI 및 비표준 컨테이너 수동 처리
CasaOS 앱 스토어 외부에서 생성된 컨테이너는 CTOZ 문서에 명시된 자동 마이그레이션 범위에 포함되지 않습니다. 바인드 마운트, 명명된 볼륨, AppData, Compose 파일, 환경 변수 및 보안 키를 확인하세요. ZimaOS를 설치한 후 이미지 또는 Compose 프로젝트를 다시 배포하고, 올바른 ZimaOS 호스트 경로를 사용해 복원한 데이터를 연결하세요.
오픈 소스 GitHub의 CTOZ 프로젝트에서는 공식 가이드에서 참조하는 도구 소스와 최신 설치 정보를 제공합니다.
CasaOS에서 ZimaOS로 마이그레이션 FAQ
CasaOS를 ZimaOS로 직접 업그레이드할 수 있나요?
아니요. ZimaOS 팀은 두 운영체제가 서로 다르다고 설명했습니다. 인플레이스 업그레이드 대신 백업을 준비하고 ZimaOS를 새로 설치하는 방식으로 마이그레이션을 계획하세요.
CasaOS 앱과 해당 데이터를 ZimaOS로 옮길 수 있나요?
대부분의 표준 CasaOS 앱 스토어 컨테이너는 AppData와 Docker Compose YAML을 포함해 CTOZ로 마이그레이션할 수 있습니다. 지원되지 않는 컨테이너나 사용자 지정 컨테이너는 수동으로 백업하고 다시 배포해야 합니다.
서버가 두 대 필요한가요?
두 시스템을 동시에 실행하면 LAN 전송과 CTOZ 온라인 마이그레이션이 더 쉬워지지만, 현재 문서에서는 오프라인 또는 독립형 마이그레이션을 위한 내보내기/가져오기 방법도 설명합니다. 단일 서버 마이그레이션의 경우에도 CasaOS를 교체하는 동안 백업을 보관할 안전한 다른 장소가 필요합니다.
Windows PC를 임시 마이그레이션 대상으로 사용할 수 있나요?
예. 공식 커뮤니티 답변에서는 ZimaOS를 설치하기 전에 파일을 Windows로 복사한 다음 다시 복사해 넣는 방법을 제안했습니다. 개인 파일뿐 아니라 앱 데이터, Compose 정의 및 구성 기록도 보존하세요.
CasaOS 사용자, 마운트 및 네트워크 설정이 자동으로 이전되나요?
아니요. 현재 안내에 따르면 시스템 사용자, 네트워크 구성, 스토리지 마운트 및 공유는 ZimaOS에서 수동으로 다시 만들거나 확인해야 합니다.
CTOZ에 필요한 CasaOS 버전은 무엇인가요?
현재 공식 가이드에서는 최신 CasaOS 버전에서 사용되는 표준화된 Docker Compose 구성을 CTOZ가 사용하므로 CasaOS 0.4.4 이상을 지정합니다.
