CasaOSとZimaOSは異なるオペレーティングシステムであるため、両者間の移行はインプレースアップグレードではなく移行作業です。ファイル、標準的なアプリデータ、多くのDocker Compose設定は転送できますが、システムユーザー、ネットワーク設定、ストレージのマウント、共有、複雑にカスタマイズされたコンテナは手動で再作成する必要がある場合があります。
コミュニティからの質問が最初に投稿された後、回答も変わりました。2025年7月、公式回答ではLAN経由でファイルをコピーし、アプリを手動で再インストールする方法が説明されていました。2025年9月には、IceWhaleが移行ガイドを公開しました。2026年9月に更新された現在のガイドには、多数のCasaOS App Storeコンテナとそのデータを転送するためのCTOZツールが追加されています。
CasaOSからZimaOSへの移行はインプレースアップグレードではない
インプレースアップグレードなら、システム設定を自動的に保持したままCasaOSが置き換えられます。しかし、ZimaOSチームが説明しているモデルはそれではありません。ZimaOSをインストールすると別のオペレーティングシステム環境が作成されるため、安全な計画は、棚卸し、バックアップ、インストール、移行、検証を行い、その後で元の環境を廃止することです。
個人ファイル、アプリケーションデータ、Compose定義、認証情報、設定メモを検証済みのストレージにコピーするまで、CasaOSシステムの唯一のコピーを上書きしないでください。
開始前にアプリのパスと設定を記録する
最初の公式回答では、各アプリの設定パネルを開き、既存のフォルダーパスを記録することが推奨されていました。自動移行ツールを利用できる場合でも、コンテナが正常に起動しながら間違ったデータディレクトリを参照している可能性があるため、これは引き続き有用です。
各アプリについて記録する項目：
- コンテナイメージとバージョン。
- ホストとコンテナのボリュームパス。
- ポートとネットワークモード。
- 環境変数とユーザーID／グループID。
- AppData、データベース、メディア、設定の各フォルダー。
- 手動で作成したDockerネットワークまたはデバイス。
CasaOSとZimaOSを同時に実行できる場合の移行
最も簡単な方法は、CasaOSのソースとZimaOSの移行先を同じLAN上で利用できる状態にすることです。必要なCasaOSフォルダーをSMBで共有し、ZimaOSの「ファイル」でその共有をマウントして、データを移行先のストレージへコピーまたは移行します。
CasaOS App Storeからインストールしたアプリについては、現在のCasaOSからZimaOSへの移行ガイドで、コミュニティ開発のCTOZツールが推奨されています。CTOZはCasaOSのAppDataディレクトリと対応するDocker Compose YAMLを転送し、ZimaOSで対応アプリを再インストールできます。
CTOZが移行するもの
- 対応するCasaOSアプリに関連付けられたAppData。
- コンテナの再作成に使用するDocker Compose YAML。
- マッピングされたフォルダーに含まれる標準的なアプリデータと設定。
CTOZが自動的に移行しないもの
- CasaOSのユーザーとシステムレベルの設定。
- ネットワーク設定、ストレージのマウント、共有設定。
- CasaOS App Store以外でデプロイされた標準外のコンテナ。
- AppDataまたはComposeファイルに記録されていない、ホストへのカスタム変更。
サーバーが1台しかない場合の移行
2025年のスレッドでは、最も難しい構成として、ベアメタル再インストール中に同じサーバー上でCasaOSとZimaOSを同時に実行できない点が取り上げられました。チームは、まずファイルをWindows PCにコピーし、ZimaOSのインストール後に戻す方法を提案しました。各アプリとそのデータは個別に処理します。
現在のガイドでは、オフラインまたはスタンドアロン環境向けのCTOZによるエクスポート／インポートについても説明しています。これによりコンテナの手動再構築を減らせますが、独立したバックアップ保存先の必要性がなくなるわけではありません。CasaOSを置き換える前に、対応アプリのデータをエクスポートし、個人ファイルおよびシステム設定の別途記録とともに、Windows PC、外付けディスク、NAS、または別の検証済み保存先へコピーしてください。
推奨されるCasaOSからZimaOSへの移行手順
- インベントリ：ファイル、共有、アプリ、ボリューム、ポート、認証情報、データベース、ユーザー、カスタムコンテナを一覧にします。
- バックアップ：CasaOSのシステムディスク外に、検証済みのコピーを少なくとも1つ作成します。データベースでは、ファイルのコピーに加えてアプリ固有のエクスポートが必要になる場合があります。
- 対応アプリをエクスポート：該当する場合は現在のCTOZワークフローを使用し、Docker Compose YAMLを保持します。
- ZimaOSをインストール：別のデバイスからバックアップを開けることを確認してから、クリーンインストールを実行します。
- ファイルを復元：個人ファイルとアプリデータを、ZimaOSの所定のストレージ場所にコピーします。
- アプリをインポートまたは再インストール：CTOZまたはZimaOSの手動Composeインポートを使用し、必要に応じてポートとボリュームパスを修正します。
- システム設定を再作成：ZimaOSでユーザー、共有、ネットワーク、マウント、権限を設定します。
- 検証：すべてのアプリを開き、データを確認し、書き込みと権限をテストしてから、バックアップを削除する前にリモートアクセスを確認します。
アプリが自動的に再インストールされない場合
現在のZimaOSドキュメントでは、自動コンテナインストールに失敗した場合でも、CTOZがAppDataを転送すると説明されています。移行先フォルダーに同じ名前のフォルダーがすでに存在する場合、ツールは上書きせずに番号を追加できます。その後、エクスポートしたCompose YAMLをZimaOS App Storeから手動でインポートできます。
自動移行の後は、アプリの設定を確認し、ボリュームパスが転送したフォルダーを指していることを確認してください。コンテナが起動しているだけでは、データベース、メディアライブラリ、設定が正しく復元された証拠にはなりません。
CLIおよび標準外コンテナは手動で処理する
CasaOS App Store以外で作成されたコンテナは、CTOZが文書化している自動移行の対象外です。バインドマウント、名前付きボリューム、AppData、Composeファイル、環境変数、シークレットの場所を確認してください。ZimaOSをインストールした後、イメージまたはComposeプロジェクトを再デプロイし、適切なZimaOSホストパスを使用して復元したデータを接続します。
オープンソースのGitHub上のCTOZプロジェクトでは、公式ガイドで参照されているツールのソースコードと最新のインストール情報を提供しています。
CasaOSからZimaOSへの移行に関するよくある質問
CasaOSからZimaOSへ直接アップグレードできますか？
いいえ。ZimaOSチームは、両者を異なるオペレーティングシステムだと説明しています。インプレースアップグレードではなく、バックアップを作成したうえで、クリーンなZimaOSインストールによる移行を計画してください。
CasaOSのアプリとそのデータをZimaOSへ移行できますか？
標準のCasaOS App Storeコンテナの多くは、AppDataやDocker Compose YAMLを含め、CTOZで移行できます。サポート対象外またはカスタムコンテナには、手動でのバックアップと再デプロイが必要です。
サーバーは2台必要ですか？
2台のシステムを同時に稼働させると、LAN経由の転送やCTOZのオンライン移行が容易になりますが、現在のドキュメントではオフラインまたはスタンドアロン移行向けのエクスポート／インポートも説明されています。1台のサーバーで移行する場合でも、CasaOSを置き換える間、バックアップを安全に保管する別の場所が必要です。
Windows PCを一時的な移行先として使用できますか？
はい。公式コミュニティの回答では、ZimaOSをインストールする前にファイルをWindowsへコピーし、その後ファイルを戻す方法が提案されていました。個人ファイルだけでなく、アプリデータ、Compose定義、設定情報も保持してください。
CasaOSのユーザー、マウント、ネットワーク設定は自動的に移行されますか？
いいえ。現在のガイダンスでは、システムユーザー、ネットワーク設定、ストレージマウント、共有は、ZimaOSで手動で再作成または確認する必要があるとされています。
CTOZにはどのバージョンのCasaOSが必要ですか？
現在の公式ガイドでは、CTOZが新しいCasaOSバージョンで使用される標準化されたDocker Compose設定に依存しているため、CasaOS 0.4.4以降が指定されています。
