2026年1月、ZimaOS App Storeからアプリをインストールしたユーザーは、ポート、環境変数、ボリュームなどの公開設定を変更できましたが、自分で所有するスタックと同じComposeレベルの制御はできませんでした。そのため、Traefikラベル、共有ネットワーク、ミドルウェア、コンテナ固有のDNSなどの高度な設定で問題が生じていました。
重要な更新は、スレッドで示されたロードマップが単なる将来計画ではなくなったことです。IceWhaleは、Docker Compose YAMLの編集機能を追加するためApp Storeをリファクタリングしていると説明し、その後ZimaOS 1.7.0でネイティブYAMLサポートが提供されました。
2026年初頭にApp Storeアプリの編集が難しかった理由
コミュニティで説明されていた理由は、App StoreからインストールしたアプリがZimaOSによって管理されていたためです。その管理経路の外部で生成済みのComposeを編集すると、再デプロイやアップグレードによって上書きされる可能性がありました。
当時、高度なユーザーが取れた現実的な回避策は、サービスをCustom Composeとしてインストールし、同じ永続AppDataフォルダーを維持したうえで、DockgeやPortainerなどのツールを使ってComposeスタックを自分で管理することでした。
高度なリバースプロキシ設定にはComposeレベルの制御が必要
元のユーザーが求めていたのは、Traefikラベルと、選択したコンテナにPi-holeではなくCloudflare DNSを使用させる方法でした。これらは、単純なアプリ名やポート設定ではなく、通常のDocker Composeに関する設定です。
現在のZimaOS App Store仕様では、この境界が明確に示されています。標準的なランタイム設定はDocker Composeに、ZimaOS固有のApp Storeメタデータはx-casaosに記述します。
IceWhaleはYAMLエディターの計画を確認した
Zima-Jerryは、簡単なインストール手順と高度なDocker Compose YAML編集を両立できるよう、チームがApp Storeとインストール体験をリファクタリングしていると回答しました。
この公式回答は、App Storeアプリを直接編集することは決してできないという、それ以前のコミュニティの見解よりも信頼性の高い情報です。
ZimaOS 1.7.0でネイティブYAMLサポートを追加
2026年7月までに、ZimaOS App Store 2.0ではアプリ管理の再設計と、より柔軟なアプリ設定のためのネイティブYAMLサポートが提供されました。現在のZimaOSでは、インストール済みアプリの状態、更新、一般的な設定もアプリ管理ページに集約されています。
現在のApp Store概要では、再設計されたZimaOSアプリケーションインターフェースから、インストール済みアプリをどのように管理するかを確認できます。
ネイティブYAMLがあっても、外部スタックがすべて自動管理されるわけではない
新しいエディターにより、ZimaOSが管理するアプリの制御性は向上しました。ただし、これはZimaOSのアプリシステム外で起動した任意のComposeスタックを完全に所有・管理できるという意味ではありません。現在の1.7.xでも、手動で起動したComposeグループと、ZimaOS自体が管理するアプリは区別されています。
所有モデルを変更するときはAppDataを保持する
管理対象のApp Storeパッケージから自己管理Composeスタックへ意図的にアプリを移行する場合、重要なデータは通常、永続化されたホストフォルダーに保存されています。まずそれらをバックアップし、古いコンテナを削除する前に、同じボリュームマッピング、ポート、環境変数、データベース依存関係を再現してください。
コンテナを再作成するだけで、ZimaOS固有の設定やシークレットがすべて自動的に移行されるとは限りません。
ZimaOSアプリYAML編集に関するFAQ
スレッドが投稿された時点で、Composeを直接編集できましたか？
ユーザーが望んでいた形ではできませんでした。コミュニティでの回避策はCustom Composeであり、IceWhaleは直接のYAML編集機能を開発中だと説明していました。
ZimaOSは最終的にネイティブYAML編集機能を追加しましたか？
はい。ZimaOS 1.7.0では、App Store 2.0の再設計の一環としてネイティブYAMLサポートが発表されました。
今でもDockgeを使うべきですか？
ZimaOSにアプリを管理させるのではなく、独立したComposeスタックを自分で所有したい場合には、今でも有用です。
Custom Composeに切り替えるとき、既存のアプリデータを保持できますか？
永続ホストフォルダーを保持して正しく再マッピングすれば、多くの場合は可能です。ただし、事前にデータをバックアップし、元のコンテナ設定を記録してください。
