> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Legacy Desktop からの移行

> Legacy Desktop インストールを Comfy Desktop に移行する方法

<Info>
  このページは **Legacy Desktop**（旧シングルインストール版）からの移行について説明します。初めて Comfy Desktop を使用する方はスキップしてください。
</Info>

<CardGroup cols={1}>
  <Card title="別のインストールをお探しですか？" icon="compass" href="/ja/installation/desktop/usage/instance-management#tracking-an-existing-installation">
    既存の ComfyUI インストール（portable、手動 git clone など）を Comfy Desktop に追加したい場合は、**インスタンス管理 → 既存のインストールを追跡する** を参照してください。
  </Card>
</CardGroup>

Legacy Desktop をすでにインストールしている場合、Comfy Desktop は自動的に検出して移行を促し、Chooser ビューに新しい Standalone インストールを作成します。

## 移行される内容

Legacy Desktop はシングルインストールのアプリです。Comfy Desktop はマルチインストールマネージャーです。移行時：

* **ワークフローと設定**：新しい Standalone インストールにコピー
* **カスタムノード**：スキャン後、新しい環境で再インストール
* **モデル**：既存のモデルフォルダが共有ディレクトリとして追加（ファイルは元の場所に残る）
* **入力ファイルと出力結果**：新しいインストールの共有ディレクトリにコピー
* **Python 環境**：新しい Python 環境を作成（Legacy のバンドル Python は再利用しません）
* **ComfyUI バージョン**：新しい Standalone に最新版をインストール

Legacy Desktop インストール自体は**変更されません**。システムにバックアップとして残ります。

## 移行後の変化

移行完了後、新しい Standalone インストールは他の Comfy Desktop インストールと同様に動作します：

* **起動方法**：Chooser ビューで新しいインストールカードの再生ボタンをクリックして起動。
* **ポート**：Legacy Desktop はデフォルトでポート `8000` を使用。移行時にはこのポート設定（およびその他のカスタム起動引数）が引き継がれます。
* **管理方法**：Manage パネルで更新、スナップショット、設定を管理。
* **更新方法**：Manage パネルで直接更新可能。Legacy Desktop のように更新のたびに新規ダウンロードする必要はありません。
* **マルチインスタンス**：複数の Standalone インストールを同時に持ち、それぞれ異なる ComfyUI バージョンと設定を使用可能。
* **共有ストレージ**：モデルはデフォルトですべての Standalone インストール間で共有。入力/出力ディレクトリは従来の Legacy ワークスペースに固定されるため、既存ファイルの位置は変わりません。

## 以前のリンクは使えますか？

Legacy Desktop はデフォルトでポート `8000` で動作していました。新しいインストールは**このポートを引き継ぐ**ため、`http://localhost:8000` はそのまま使えるはずです。

カスタム起動引数（例：`--port 8188`）を設定していた場合も、それらは引き継がれます。

URL短縮サービスやブックマーク、外部連携で Legacy Desktop アプリを異なるアドレスで参照している場合は、新しいインストールの Startup Args タブを確認し、適宜更新してください。

## 移行手順

<Steps>
  <Step title="Comfy Desktop をインストール">
    [公式ダウンロードページ](https://comfy.org/download) から Comfy Desktop をダウンロードしてインストールします。
  </Step>

  <Step title="Comfy Desktop を起動">
    初めて Comfy Desktop を開くと、Legacy Desktop インストールを自動検出して移行を促します。
  </Step>

  <Step title="移行を確認">
    **Migrate Now** をクリックして移行を開始します：

    1. 既存のインストールをスキャン（カスタムノード、モデル、ワークフロー）
    2. 新しい Standalone インストールを作成（新規 Python 環境 + 最新 ComfyUI）
    3. ユーザーデータ（ワークフロー、設定など）をコピー
    4. 入力ファイルと出力結果をコピー
    5. モデルフォルダを共有ディレクトリとして追加
    6. 新しい環境にカスタムノードをインストール

    完了後、新しい Standalone インストールカードが Chooser ビューに表示されます。
  </Step>

  <Step title="確認">
    新しいインストールを起動して確認：

    * ワークフローが利用可能
    * カスタムノードがインストール済み
    * モデルにアクセス可能
    * サーバーが引き継いだ URL で動作（デフォルト `http://localhost:8000`）
  </Step>
</Steps>

## トラブルシューティング

### Legacy Desktop が自動検出されない

移行プロンプトが表示されない場合、手動で移行できます：

1. Chooser ビューで **+** カードをクリック
2. **Legacy Desktop** を選択
3. Legacy Desktop インストールを選んでプロンプトに従う

既存のインストールが Chooser でまったく検出されない場合は、Manage パネルから直接追加することもできます。[**既存のインストールを追跡する**](/ja/installation/desktop/usage/instance-management#tracking-an-existing-installation) を参照してください。

### 移行に失敗する

* **ログを確認**：Manage パネルの Console タブでエラー詳細を確認
* **Legacy インストールが完全であることを確認**：移行は既存インストールを読み込みます
* **再試行**：ネットワークの問題は再試行で解決する場合があります

### 移行後、モデルが見つからない

モデルは共有ディレクトリパスとして追加されます（コピーされません）。モデルが表示されない場合：

1. 移行したインストールの **Manage** パネルを開く
2. **Settings → Model directories** に移動
3. 古いモデルフォルダがリストにあるか確認。ない場合は手動で追加。