2026년 1월, ZimaOS 앱 스토어에서 앱을 설치한 사용자는 포트, 환경 변수, 볼륨과 같이 외부에 노출된 설정을 변경할 수 있었지만, 직접 소유한 스택과 동일한 Compose 수준의 제어 권한은 없었습니다. 이로 인해 Traefik 라벨, 공유 네트워크, 미들웨어 또는 컨테이너별 DNS와 같은 고급 설정을 구성하기 어려웠습니다.
중요한 업데이트는 스레드에서 언급된 로드맵이 더 이상 단순한 미래 계획이 아니라는 점입니다. IceWhale은 Docker Compose YAML 편집 기능을 추가하기 위해 앱 스토어를 리팩터링한다고 밝혔으며, 이후 ZimaOS 1.7.0에서 기본 YAML 지원이 제공되었습니다.
2026년 초 앱 스토어 앱을 편집하기 어려웠던 이유
커뮤니티에서는 스토어에서 설치한 앱을 ZimaOS가 관리하기 때문이라고 설명했습니다. 해당 관리 경로를 벗어나 생성된 Compose 설정을 편집하면 재배포 또는 업그레이드 과정에서 변경 사항이 덮어써질 수 있었습니다.
당시 고급 사용자를 위한 실질적인 해결 방법은 서비스를 Custom Compose로 설치하고 동일한 영구 AppData 폴더를 유지한 다음, Dockge 또는 Portainer와 같은 도구로 Compose 스택을 직접 관리하는 것이었습니다.
고급 리버스 프록시 설정에는 Compose 수준의 제어가 필요합니다
원래 사용자는 특히 Traefik 라벨을 설정하고, 일부 컨테이너가 Pi-hole 대신 Cloudflare DNS를 사용하도록 강제하는 방법을 원했습니다. 이러한 설정은 단순한 앱 제목이나 포트 설정이 아니라 일반적인 Docker Compose 구성에 해당합니다.
현재 ZimaOS 앱 스토어 사양은 이러한 경계를 명확히 설명합니다. 표준 런타임 구성은 Docker Compose에 속하고, ZimaOS 관련 스토어 메타데이터는 x-casaos에 속합니다.
IceWhale은 YAML 편집기 도입 계획을 확인했습니다
Zima-Jerry는 간편한 설치 경로와 고급 Docker Compose YAML 편집 기능을 함께 제공할 수 있도록 팀에서 앱 스토어와 설치 환경을 리팩터링하고 있다고 답변했습니다.
이 공식 답변은 스토어 앱을 직접 편집할 수 없다는 초기 커뮤니티의 추측보다 더 신뢰할 수 있는 정보입니다.
ZimaOS 1.7.0에서 기본 YAML 지원이 추가되었습니다
2026년 7월까지 ZimaOS 앱 스토어 2.0에는 앱 관리 개편과 더욱 유연한 애플리케이션 구성을 위한 기본 YAML 지원이 포함되었습니다. 현재 ZimaOS는 앱 관리 페이지에서 설치된 앱의 상태, 업데이트 및 일반 설정도 통합 관리합니다.
현재 앱 스토어 개요에서는 개편된 ZimaOS 애플리케이션 인터페이스에서 설치된 앱을 관리하는 방법을 확인할 수 있습니다.
기본 YAML 지원이 모든 외부 스택을 자동으로 관리한다는 뜻은 아닙니다
새로운 편집기는 ZimaOS가 관리하는 애플리케이션에 대한 제어 기능을 향상하지만, ZimaOS 앱 시스템 외부에서 시작한 임의의 Compose 스택을 완전히 소유하고 관리할 수 있다는 의미는 아닙니다. 현재 1.7.x 관련 보고에서도 수동으로 실행한 Compose 그룹과 ZimaOS가 직접 관리하는 앱을 구분하고 있습니다.
소유권 모델을 변경할 때는 AppData를 보존하세요
관리되는 스토어 패키지에서 자체 관리 Compose 스택으로 앱을 의도적으로 이전하는 경우, 중요한 데이터는 일반적으로 영구 호스트 폴더에 저장됩니다. 먼저 해당 폴더를 백업한 다음, 기존 컨테이너를 제거하기 전에 동일한 볼륨 매핑, 포트, 환경 변수 및 데이터베이스 종속성을 재현하세요.
컨테이너를 다시 만든다고 해서 모든 ZimaOS 관련 설정이나 시크릿이 자동으로 이전된다고 가정하지 마세요.
ZimaOS 앱 YAML 편집 FAQ
스레드가 게시될 당시 직접 Compose를 편집할 수 있었나요?
사용자가 원한 방식으로는 불가능했습니다. 커뮤니티에서 제시한 해결 방법은 Custom Compose를 사용하는 것이었고, IceWhale은 직접 YAML 편집 기능을 개발 중이라고 밝혔습니다.
ZimaOS에 결국 기본 YAML 편집 기능이 추가되었나요?
예. ZimaOS 1.7.0에서 앱 스토어 2.0 개편의 일환으로 기본 YAML 지원이 제공되었습니다.
그래도 Dockge를 사용해야 하나요?
ZimaOS가 애플리케이션을 관리하도록 하기보다 독립적인 Compose 스택을 직접 소유하고 관리하려는 경우에는 여전히 유용할 수 있습니다.
Custom Compose로 전환할 때 기존 애플리케이션 데이터를 유지할 수 있나요?
영구 호스트 폴더를 보존하고 올바르게 다시 매핑하면 대체로 가능합니다. 하지만 먼저 데이터를 백업하고 기존 컨테이너 설정을 기록해 두세요.
