diff --git a/docs.json b/docs.json
index 5edde6bd..a86d9bb7 100644
--- a/docs.json
+++ b/docs.json
@@ -36,6 +36,26 @@
"installation/desktop/linux"
]
},
+ {
+ "group": "Desktop 2.0 (Beta)",
+ "pages": [
+ "installation/desktop-2/overview",
+ "installation/desktop-2/windows",
+ "installation/desktop-2/macos",
+ "installation/desktop-2/linux",
+ "installation/desktop-2/usage"
+ ]
+ },
+ {
+ "group": "Desktop 2.0 (Beta)",
+ "pages": [
+ "installation/desktop-2/overview",
+ "installation/desktop-2/windows",
+ "installation/desktop-2/macos",
+ "installation/desktop-2/linux",
+ "installation/desktop-2/usage"
+ ]
+ },
"installation/comfyui_portable_windows",
"installation/manual_install",
"installation/update_comfyui"
diff --git a/installation/desktop-2/linux.mdx b/installation/desktop-2/linux.mdx
new file mode 100644
index 00000000..dcd08d53
--- /dev/null
+++ b/installation/desktop-2/linux.mdx
@@ -0,0 +1,120 @@
+---
+title: "Linux — ComfyUI Desktop 2.0"
+description: "Install and set up ComfyUI Desktop 2.0 on Linux"
+icon: "linux"
+sidebarTitle: "Linux"
+---
+
+import TroubleshootingGpt from "/snippets/install/troubleshooting-gpt.mdx"
+import TroubleshootingFeedback from "/snippets/install/troubleshooting-feedback.mdx"
+
+**ComfyUI Desktop 2.0** is a multi-installation manager that lets you run multiple ComfyUI instances from a single launcher. This guide walks you through installing and using Desktop 2.0 on Linux.
+
+ComfyUI Desktop 2.0 is an open source project. View the source code on [GitHub](https://github.com/Comfy-Org/ComfyUI-Desktop-2.0-Beta).
+
+ComfyUI Desktop 2.0 is currently in **Beta**. The installation process and features may change.
+
+## System Requirements
+
+- **OS:** Debian-based distribution (Ubuntu 22.04+ recommended)
+- **GPU:** NVIDIA GPU with CUDA support (recommended)
+- **Disk Space:** At least 15 GB recommended per installation
+- **AppArmor:** Required for `.deb` installations
+
+## Download
+
+Desktop 2.0 is available as a `.deb` package or AppImage:
+
+
+ Download AppImage
+
+
+For the `.deb` package, download the latest release from the [GitHub Releases](https://github.com/Comfy-Org/ComfyUI-Desktop-2.0-Beta/releases) page.
+
+## Installation
+
+### Option 1: .deb Package (Debian/Ubuntu)
+
+```bash
+sudo apt install ./ComfyUI-Desktop-2.0-*.deb
+```
+
+Then launch from your application menu.
+
+### Option 2: AppImage
+
+```bash
+chmod +x ComfyUI-Desktop-2.0-*.AppImage
+./ComfyUI-Desktop-2.0-*.AppImage --no-sandbox
+```
+
+You may want to move the AppImage to a permanent location, such as `~/Applications/` or `/opt/`.
+
+## First Launch
+
+The first time you launch, you'll see the **Welcome to ComfyUI Desktop** screen. Click **Get Started** to begin.
+
+### Choose How to Install
+
+
+
+ Select **Quick Install** — this creates a fresh standalone ComfyUI installation:
+
+ 1. Choose your **GPU**: Select **NVIDIA GPU (Recommended)**
+ 2. Choose an **installation directory** (a separate empty folder)
+ 3. Configure optional settings:
+ - **Automatic Updates**: Enable to auto-update ComfyUI when available
+ - **Usage Metrics**: Send anonymous usage data
+ - **Mirror Settings**: Configure mirrors if GitHub access is slow
+ 4. Click **Install** — Desktop 2.0 downloads Python, sets up the environment, installs ComfyUI, and launches it
+
+
+ If you already have a ComfyUI installation, select **Track Existing Install** to point Desktop 2.0 to an existing git clone or other installation.
+
+
+
+## Using Desktop 2.0 on Linux
+
+All the core features work the same as on Windows/macOS — see the [Windows guide](/installation/desktop-2/windows) for details on:
+- The Chooser View and managing installations
+- Snapshots and updates
+- Model downloads
+- Global settings and proxy mirrors
+
+## Data Locations
+
+Desktop 2.0 follows the [XDG Base Directory Specification](https://wiki.archlinux.org/title/XDG_Base_Directory) on Linux:
+
+| Data | Linux Path |
+|------|-----------|
+| Config (`settings.json`) | `~/.config/comfyui-desktop-2` |
+| Data (`installations.json`) | `~/.local/share/comfyui-desktop-2` |
+| Cache (`download-cache/`) | `~/.cache/comfyui-desktop-2` |
+| State (`port-locks/`) | `~/.local/state/comfyui-desktop-2` |
+| Default install directory | `~/ComfyUI-Installs` |
+
+## Updating Desktop 2.0
+
+- **AppImage:** Download the latest AppImage and replace the existing one
+- **`.deb`:** Use `sudo apt upgrade` or download the latest `.deb` and reinstall
+- **From the app:** Desktop 2.0 checks for updates automatically; look for notifications in the app
+
+## Troubleshooting
+
+### AppImage sandbox warning
+
+If you see a sandbox warning when running the AppImage, use `--no-sandbox`:
+
+```bash
+./ComfyUI-Desktop-2.0-*.AppImage --no-sandbox
+```
+
+### Installation fails with mirror errors
+
+Expand the mirror settings during installation and configure working mirrors for Python, PyPI, and Torch packages.
+
+
+
diff --git a/installation/desktop-2/macos.mdx b/installation/desktop-2/macos.mdx
new file mode 100644
index 00000000..00466b74
--- /dev/null
+++ b/installation/desktop-2/macos.mdx
@@ -0,0 +1,144 @@
+---
+title: "macOS — ComfyUI Desktop 2.0"
+description: "Install and set up ComfyUI Desktop 2.0 on macOS"
+icon: "apple"
+sidebarTitle: "macOS"
+---
+
+import TroubleshootingGpt from "/snippets/install/troubleshooting-gpt.mdx"
+import TroubleshootingFeedback from "/snippets/install/troubleshooting-feedback.mdx"
+
+**ComfyUI Desktop 2.0** is a multi-installation manager that lets you run multiple ComfyUI instances from a single launcher. This guide walks you through installing and using Desktop 2.0 on macOS.
+
+ComfyUI Desktop 2.0 is an open source project. View the source code on [GitHub](https://github.com/Comfy-Org/ComfyUI-Desktop-2.0-Beta).
+
+ComfyUI Desktop 2.0 is currently in **Beta**. The installation process and features may change.
+
+## System Requirements
+
+- **OS:** macOS 13 (Ventura) or later
+- **Hardware:** Apple Silicon (M1 or later)
+- **Disk Space:** At least 15 GB recommended per installation
+
+## Download
+
+
+ Download for macOS (Apple Silicon)
+
+
+## Installation
+
+### Step 1 — Install the App
+
+1. Open the downloaded `.dmg` file
+2. Drag **ComfyUI Desktop 2.0** into the **Applications** folder
+3. Launch it from Launchpad or Spotlight
+
+### Step 2 — First Launch
+
+The first time you launch, macOS may show a security warning since the app is not notarized. Go to **System Settings → Privacy & Security** and click **Open Anyway** to allow it.
+
+After launching, you'll see the **Welcome to ComfyUI Desktop** screen. Click **Get Started** to begin.
+
+### Step 3 — Choose How to Install
+
+You have two main paths:
+
+
+
+ Select **Quick Install** — this creates a fresh standalone ComfyUI installation:
+
+ 1. Choose your **GPU**: Select **MPS (Recommended)** for Apple Silicon
+ 2. Choose an **installation directory** (a separate empty folder)
+ 3. Configure optional settings:
+ - **Automatic Updates**: Enable to auto-update ComfyUI when available
+ - **Usage Metrics**: Send anonymous usage data
+ - **Mirror Settings**: Configure mirrors if GitHub access is slow in your region
+ 4. Click **Install** — Desktop 2.0 downloads Python, sets up the environment, installs ComfyUI, and launches it
+
+
+ If you already have a ComfyUI installation, select **Track Existing Install**:
+
+ - **Git Clone** — Point to an existing ComfyUI git repository folder
+ - **Legacy Desktop** — Desktop 2.0 will detect existing Desktop 1.0 installations
+
+
+
+## First Launch
+
+After installation, Desktop 2.0 opens the **Chooser** view — a grid of all your ComfyUI installations. Click any installation card to launch it.
+
+Each card shows:
+- Installation name and type (Standalone, Cloud, Git, etc.)
+- Last launched timestamp
+- Status indicators (running, error, update available)
+
+## Managing Installations
+
+### The Chooser View
+
+The main screen shows all your installations in a tile grid. Use the filter chips at the top to narrow by source category.
+
+### Installation Actions
+
+Right-click any installation card (or click the ⋮ icon) to access:
+
+- **Launch** — Start the ComfyUI backend and open the editor
+- **Manage** — Open the per-installation settings panel
+- **Update** — Update ComfyUI to the latest version
+- **Restore Snapshot** — Revert to a saved snapshot
+- **Open Folder** — Open the installation directory in Finder
+- **Delete** — Remove the installation
+
+### Snapshots
+
+Desktop 2.0 automatically captures a **snapshot** before every update, recording the current ComfyUI version, installed custom nodes, and Python packages. You can restore any snapshot at any time.
+
+### In-App Terminal
+
+Access the ComfyUI Python environment directly from the app:
+1. Click the terminal icon in the menu bar to open the bottom panel
+2. Click **Terminal** to open the terminal
+3. Run Python commands in the correct environment without needing to activate the virtual environment manually
+
+### Model Downloads
+
+Desktop 2.0 includes a built-in model download manager. Track download progress from the Downloads panel accessible from the title bar.
+
+## Data Locations
+
+| Data | macOS Path |
+|------|-----------|
+| App data (settings, installations list) | `~/Library/Application Support/ComfyUI Desktop 2.0` |
+| Logs | `~/Library/Application Support/ComfyUI Desktop 2.0/logs` |
+| Default install directory | User-chosen during setup |
+
+## Updating Desktop 2.0
+
+Desktop 2.0 checks for updates automatically. When an update is available, a notification will appear. You can also check manually from Global Settings.
+
+You can also download the latest version directly:
+- [macOS Apple Silicon](https://dl.todesktop.com/241130tqe9q3y/mac/dmg/arm64)
+
+## Uninstalling
+
+To uninstall Desktop 2.0:
+1. Delete **ComfyUI Desktop 2.0** from your Applications folder
+2. To remove all data, delete `~/Library/Application Support/ComfyUI Desktop 2.0`
+3. Delete any installation directories you created during setup
+
+## Troubleshooting
+
+### macOS security warning
+
+If macOS blocks the app, go to **System Settings → Privacy & Security**, scroll to the bottom, and click **Open Anyway** next to the ComfyUI entry.
+
+### Installation fails with mirror errors
+
+If mirrors fail during installation, expand the mirror settings and configure working mirrors for Python, PyPI, and Torch packages.
+
+
+
diff --git a/installation/desktop-2/overview.mdx b/installation/desktop-2/overview.mdx
new file mode 100644
index 00000000..ffd46b6c
--- /dev/null
+++ b/installation/desktop-2/overview.mdx
@@ -0,0 +1,92 @@
+---
+title: "ComfyUI Desktop 2.0 Overview"
+description: "Learn about ComfyUI Desktop 2.0 — a modern desktop app for managing multiple ComfyUI installations"
+icon: "desktop"
+sidebarTitle: "Overview"
+---
+
+**ComfyUI Desktop 2.0** is a next-generation desktop application that lets you install, manage, and launch multiple ComfyUI instances from a single place. Unlike the original Desktop (single-install), Desktop 2.0 is a multi-installation manager — think of it as a launcher for all your ComfyUI environments.
+
+## Key Features
+
+### Multi-Installation Management
+
+Desktop 2.0 supports several types of ComfyUI installations:
+
+| Source Type | Description |
+|-------------|-------------|
+| **Standalone** | A self-contained install with its own bundled Python and dependencies — clean, isolated, and easy to manage |
+| **Cloud** | Connect to Comfy Cloud for remote GPU-powered workflows |
+| **Git Clone** | Track an existing ComfyUI git clone with a Python venv — ideal for developers |
+| **Portable** | Import existing ComfyUI portable installations (Windows) |
+| **Legacy Desktop** | Detect and migrate existing Desktop 1.0 installations |
+| **Remote Connection** | Connect to a running ComfyUI instance on another machine |
+
+### What You Can Do
+
+- **Quick Install** — Install a fresh standalone ComfyUI with one click, with automatic Python environment setup
+- **Run Multiple Instances** — Launch and switch between different ComfyUI versions side by side
+- **Snapshots** — Automatic snapshots capture your custom nodes, models, and settings before every update; restore to any previous snapshot at any time
+- **One-Click Updates** — Update ComfyUI installations with a single click
+- **Model Downloads** — Built-in model download manager with progress tracking
+- **In-App Terminal** — Access the ComfyUI Python environment directly from the app
+- **Global Settings** — Configure themes, proxy mirrors for China users, and anonymous usage metrics
+
+## How It Works
+
+Desktop 2.0 separates the **launcher** from the **workflow editor**. The app manages your installations; each installation runs its own ComfyUI backend (with its own Python environment). When you launch an installation, it opens in a separate window with the full ComfyUI workflow editor.
+
+```mermaid
+flowchart LR
+ A[Desktop 2.0 Launcher] --> B[Installation 1
v0.3.2]
+ A --> C[Installation 2
v0.2.4]
+ A --> D[Cloud Instance]
+ A --> E[Remote Server]
+ B --> F[ComfyUI Editor Window]
+ C --> G[ComfyUI Editor Window]
+ D --> H[Browser Tab]
+```
+
+## System Requirements
+
+### Windows
+- **OS:** Windows 10 or later
+- **GPU:** NVIDIA GPU with CUDA support
+- **Architecture:** x64 or ARM64
+
+### macOS
+- **OS:** macOS 13 (Ventura) or later
+- **Hardware:** Apple Silicon (M1 or later)
+
+### Linux
+- **OS:** Ubuntu 22.04+ (Debian-based distributions)
+- **GPU:** NVIDIA GPU with CUDA support (recommended)
+
+### General
+- **Disk Space:** At least 15 GB for each standalone installation
+- **RAM:** 8 GB minimum, 16 GB recommended
+- **Internet:** Required for installation and updates
+
+## Desktop 2.0 vs Desktop 1.0
+
+| Feature | Desktop 1.0 | Desktop 2.0 |
+|---------|-------------|-------------|
+| Installation type | Single ComfyUI instance | Multi-installation manager |
+| Python management | Bundled single env | Per-instance isolated Python environments |
+| Snapshots | Not available | Automatic snapshots before updates |
+| Cloud support | No | Native Comfy Cloud integration |
+| Multiple versions | No | Run different versions side by side |
+| Git clone support | No | Yes |
+| Remote connection | No | Yes |
+
+## Open Source
+
+ComfyUI Desktop 2.0 is fully open source. View the source code on [GitHub](https://github.com/Comfy-Org/ComfyUI-Desktop-2.0-Beta).
+
+## Getting Started
+
+Ready to get started? Choose your platform:
+
+- [Windows Installation](/installation/desktop-2/windows)
+- [macOS Installation](/installation/desktop-2/macos)
+- [Linux Installation](/installation/desktop-2/linux)
diff --git a/installation/desktop-2/usage.mdx b/installation/desktop-2/usage.mdx
new file mode 100644
index 00000000..69c56ad7
--- /dev/null
+++ b/installation/desktop-2/usage.mdx
@@ -0,0 +1,231 @@
+---
+title: "Using ComfyUI Desktop 2.0"
+description: "A comprehensive guide to using ComfyUI Desktop 2.0 — managing installations, launching ComfyUI, snapshots, and more"
+icon: "book-open"
+sidebarTitle: "Usage Guide"
+---
+
+This guide covers how to use ComfyUI Desktop 2.0 after installation.
+
+## The Chooser View
+
+The **Chooser** is the main screen you see when you open Desktop 2.0. It displays all your ComfyUI installations as cards in a grid.
+
+### Installation Cards
+
+Each card shows:
+- **Name** — The name you gave the installation
+- **Type icon** — Indicates the source type (Standalone, Cloud, Git, Legacy Desktop, Remote)
+- **Last launched** — How long ago you last used it
+- **Status** — Running, error, or update-available indicators
+
+### Filtering
+
+Use the filter chips at the top of the grid to narrow down installations:
+
+- **All** — Shows everything
+- **Local** — Standalone and Legacy Desktop installations
+- **Cloud** — Comfy Cloud connections only
+- **Remote** — Remote server connections only
+
+## Adding New Installations
+
+### Creating a New Install
+
+Click the **New Install** card (top-left, marked with a + icon) to add a new ComfyUI installation:
+
+1. **Choose a source type**: Standalone, Cloud, Git Clone, Portable, Legacy Desktop, or Remote Connection
+2. **Configure**: Fill in the required fields (name, path, version, etc.)
+3. **Install**: Desktop 2.0 handles the rest — downloading Python, setting up the environment, and installing ComfyUI
+
+### Source Types Explained
+
+| Source Type | Best For |
+|-------------|----------|
+| **Standalone** | Most users. Self-contained install with bundled Python, automatic updates, and snapshot support |
+| **Cloud** | Users who want remote GPU power. Connects to Comfy Cloud for workflow execution |
+| **Git Clone** | Developers who want to track a specific branch or modify ComfyUI source code |
+| **Portable** | Users migrating from the official Windows portable version |
+| **Legacy Desktop** | Users upgrading from Desktop 1.0 |
+| **Remote Connection** | Connecting to a ComfyUI instance running on another machine or server |
+
+### Quick Install
+
+The **Quick Install** option creates a standalone installation with sensible defaults:
+
+1. Select your **GPU type** (NVIDIA, MPS for Apple Silicon, or CPU-only)
+2. Pick an **installation directory**
+3. Configure optional **mirror settings** (useful in regions with slow GitHub access)
+4. Click **Install**
+
+Desktop 2.0 will show progress as it downloads Python, sets up the virtual environment, and installs ComfyUI. When complete, the new installation card appears in the Chooser grid.
+
+## Launching ComfyUI
+
+Click any installation card to launch it. Desktop 2.0 will:
+1. Start the ComfyUI backend process
+2. Wait for it to be ready
+3. Open a ComfyUI editor window
+
+If the installation is already running, clicking the card brings the existing window to focus instead of starting a new instance.
+
+### Running Multiple Instances
+
+You can launch multiple installations simultaneously. Each runs independently:
+- Each has its own Python environment
+- Each has its own ComfyUI version and custom nodes
+- Each runs on a different port
+- Each opens in its own window
+
+## Managing Installations
+
+### Installation Actions
+
+Right-click an installation card (or click the ⋮ icon) to access actions:
+
+| Action | Description |
+|--------|-------------|
+| **Launch / Restart** | Start or restart the ComfyUI instance |
+| **Manage** | Open the full settings panel for this installation |
+| **Update** | Update ComfyUI to the latest version |
+| **Restore Snapshot** | Revert to a previously saved snapshot |
+| **Open Folder** | Open the installation directory in your file manager |
+| **Delete** | Remove this installation (does not delete model files) |
+
+### The Manage Panel
+
+Selecting **Manage** on an installation opens the settings panel with several tabs:
+
+#### Status Tab
+Shows:
+- Current ComfyUI version
+- Disk space usage
+- Last launch time
+- Launch / Stop / Restart controls
+
+#### Update Tab
+- Check for new ComfyUI versions
+- One-click update installation
+- Shows changelog for available updates
+
+#### Snapshots Tab
+- View all saved snapshots
+- Restore to any previous state
+- Manual snapshot creation
+- Snapshot comparison (shows what changed between snapshots)
+
+#### Settings Tab
+Configure per-installation ComfyUI settings:
+- **ComfyUI arguments** — Custom CLI arguments (e.g., `--gpu-only`, `--highvram`, `--listen 0.0.0.0`)
+- **Environment variables** — Set custom environment variables for this installation
+- **Model directories** — Add external model directories
+- **Launch settings** — Configure extra ports, queue size, etc.
+
+### Editing an Installation
+
+You can edit an installation's name, path, and configuration after creation. Use the pencil icon (✏️) next to the installation name to rename it.
+
+## Snapshots
+
+Desktop 2.0 automatically creates a **snapshot** before each update. Snapshots capture:
+- The ComfyUI version (git commit hash)
+- All installed custom nodes (with versions)
+- Python package list
+
+### Viewing Snapshots
+
+Go to the **Snapshots** tab in the Manage panel. Each snapshot shows:
+- Date and time it was created
+- ComfyUI version at that point
+- Whether it was auto-created or manual
+
+### Restoring a Snapshot
+
+To restore to a previous state:
+1. Open the **Manage** panel for the installation
+2. Go to the **Snapshots** tab
+3. Click **Restore** on the snapshot you want to revert to
+4. Confirm — Desktop 2.0 will roll back ComfyUI and all custom nodes
+
+### Manual Snapshots
+
+You can also create snapshots manually before making significant changes, giving you a guaranteed rollback point.
+
+## The In-App Terminal
+
+Desktop 2.0 provides a built-in terminal for accessing the ComfyUI Python environment:
+
+1. Click the terminal icon (⊞) in the title bar to open the bottom panel
+2. Click the **Terminal** tab
+3. You're now in the active installation's Python virtual environment
+
+This is useful for:
+- Installing custom node dependencies with pip
+- Checking Python version or package list
+- Debugging installation issues
+
+## Model Downloads
+
+Desktop 2.0 includes a built-in model download manager:
+
+1. When you add a workflow that requires models, the ComfyUI Manager will trigger downloads
+2. Track progress from the **Downloads** panel (accessible from the title bar)
+3. Downloads continue in the background while you use the app
+
+## Global Settings
+
+Access Global Settings from the gear icon (⚙️) in the left sidebar.
+
+### General
+
+- **Theme** — Choose between System (follows OS), Light, or Dark
+- **Auto-update** — Enable/disable automatic update checking
+- **Usage Metrics** — Opt in or out of anonymous usage data collection
+
+### Proxy / Mirror Settings
+
+Useful for users in regions with restricted internet access:
+- **Python Install Mirror** — Replace the Astral python-build-standalone download URL
+- **Pypi Install Mirror** — Set a custom pip mirror
+- **Torch Install Mirror** — Set a custom PyTorch download mirror
+
+## Data Locations
+
+Desktop 2.0 stores data in platform-specific directories:
+
+### Windows
+```
+App data: %APPDATA%\ComfyUI Desktop 2.0
+Logs: %APPDATA%\ComfyUI Desktop 2.0\logs
+```
+
+### macOS
+```
+App data: ~/Library/Application Support/ComfyUI Desktop 2.0
+Logs: ~/Library/Application Support/ComfyUI Desktop 2.0/logs
+```
+
+### Linux (XDG Base Directory)
+```
+Config: ~/.config/comfyui-desktop-2
+Data: ~/.local/share/comfyui-desktop-2
+Cache: ~/.cache/comfyui-desktop-2
+State: ~/.local/state/comfyui-desktop-2
+```
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+R` / `Cmd+R` | Refresh the current view |
+| `Ctrl+W` / `Cmd+W` | Close the current panel |
+| `Escape` | Close modal or overlay |
+| `Ctrl+,` / `Cmd+,` | Open Global Settings |
+
+## Tips & Best Practices
+
+- **Name installations descriptively** — If you run multiple installs, use names like "Stable", "Dev", "v0.2.5-test" to keep them straight
+- **Take snapshots before big changes** — Even though Desktop 2.0 auto-snapshots on updates, create a manual snapshot before manually modifying custom nodes or core files
+- **Use filters when you have many installations** — The filter chips help you quickly find the installation you need
+- **Check for updates regularly** — New ComfyUI versions bring features and fixes
+- **Set up mirrors if you're in China** — The mirror settings make a big difference in installation speed and reliability
diff --git a/installation/desktop-2/windows.mdx b/installation/desktop-2/windows.mdx
new file mode 100644
index 00000000..4daf4e99
--- /dev/null
+++ b/installation/desktop-2/windows.mdx
@@ -0,0 +1,184 @@
+---
+title: "Windows — ComfyUI Desktop 2.0"
+description: "Install and set up ComfyUI Desktop 2.0 on Windows"
+icon: "windows"
+sidebarTitle: "Windows"
+---
+
+import TroubleshootingGpt from "/snippets/install/troubleshooting-gpt.mdx"
+import TroubleshootingFeedback from "/snippets/install/troubleshooting-feedback.mdx"
+
+**ComfyUI Desktop 2.0** is a multi-installation manager that lets you run multiple ComfyUI instances from a single launcher. This guide walks you through installing and using Desktop 2.0 on Windows.
+
+ComfyUI Desktop 2.0 is an open source project. View the source code on [GitHub](https://github.com/Comfy-Org/ComfyUI-Desktop-2.0-Beta).
+
+ComfyUI Desktop 2.0 is currently in **Beta**. The installation process and features may change.
+
+## System Requirements
+
+- **OS:** Windows 10 or later
+- **GPU:** NVIDIA GPU with CUDA support
+- **Architecture:** x64 or ARM64
+- **Disk Space:** At least 15 GB recommended per installation
+
+## Download
+
+Choose the installer for your system architecture:
+
+
+ Download for Windows x64
+
+
+
+ Download for Windows ARM64
+
+
+## Installation
+
+### Step 1 — Run the Installer
+
+Double-click the downloaded `.exe` installer. The installer will set up Desktop 2.0 and create a shortcut in the Start Menu.
+
+### Step 2 — First Launch
+
+Open ComfyUI Desktop 2.0 from the Start Menu. The first time you launch it, you'll see the **Welcome to ComfyUI Desktop** screen. This is where you set up your first ComfyUI installation.
+
+Click **Get Started** to begin.
+
+### Step 3 — Choose How to Install
+
+You have two main paths:
+
+
+
+ Select **Quick Install** — this creates a fresh standalone ComfyUI installation with everything bundled:
+
+ 1. Choose your **GPU**: Select **NVIDIA GPU (Recommended)**
+ 2. Choose an **installation directory** (a separate empty folder)
+ 3. Configure optional settings:
+ - **Automatic Updates**: Enable to auto-update ComfyUI when new versions are available
+ - **Usage Metrics**: Send anonymous usage data to help improve the app
+ - **Mirror Settings**: If you're in a region where GitHub access is slow, expand this section to set custom mirrors for Python and PyTorch downloads
+ 4. Click **Install** — Desktop 2.0 will download bundled Python, set up the environment, install ComfyUI, and launch it
+
+
+ If you already have a ComfyUI installation (git clone, portable, or Desktop 1.0), select **Track Existing Install**:
+
+ - **Git Clone** — Point to an existing ComfyUI git repository folder; Desktop 2.0 will detect its Python venv
+ - **Portable** — Select your existing ComfyUI portable directory
+ - **Legacy Desktop** — Desktop 2.0 will automatically detect any existing Desktop 1.0 installations
+
+
+
+## First Launch
+
+After installation, Desktop 2.0 opens the **Chooser** view — a grid of all your ComfyUI installations. Click any installation card to launch it.
+
+
+
+Each card shows:
+- Installation name and type (Standalone, Cloud, Git, etc.)
+- Last launched timestamp
+- Status indicators (running, error, update available)
+
+## Managing Installations
+
+### The Chooser View
+
+The main screen shows all your installations in a golden-ratio tile grid. Use the filter chips at the top to narrow by source category:
+
+| Filter | Shows |
+|--------|-------|
+| **All** | All installations |
+| **Local** | Standalone and Legacy Desktop installations |
+| **Cloud** | Comfy Cloud connections |
+| **Remote** | Remote server connections |
+
+### Installation Actions
+
+Right-click any installation card (or click the ⋮ icon) to access:
+
+- **Launch** — Start the ComfyUI backend and open the editor
+- **Manage** — Open the per-installation settings panel
+- **Update** — Update ComfyUI to the latest version
+- **Restore Snapshot** — Revert to a saved snapshot
+- **Open Folder** — Open the installation directory in File Explorer
+- **Delete** — Remove the installation
+
+### The Settings Panel
+
+Click the settings gear icon (⚙️) in the left sidebar to access three panels:
+
+#### 1. ComfyUI Settings (Per-Installation)
+
+Opens when you select **Manage** on an installation card. Tabs include:
+
+- **Status** — View installation version, disk usage, and launch ComfyUI
+- **Update** — Check for and apply ComfyUI updates
+- **Snapshots** — View, create, and restore snapshots
+- **Settings** — Configure ComfyUI arguments, environment variables, and model directories
+
+#### 2. Shared Directories
+
+Manage model and media directories shared across all installations:
+
+- **Models** — Add external model directories
+- **Media** — View input and output directories
+
+#### 3. Global Settings
+
+Configure Desktop 2.0's global behavior:
+
+- **General** — Theme (System/Light/Dark), auto-update checking, anonymous usage metrics
+- **Proxy / Mirror Settings** — Custom Python Install, PyPI, and Torch mirrors (especially useful for users in China)
+
+### Snapshots
+
+Desktop 2.0 automatically captures a **snapshot** before every update, recording:
+- Current ComfyUI version
+- Installed custom nodes
+- Python packages
+
+You can restore any snapshot at any time, effectively rolling back both ComfyUI and its custom nodes to a previous state. This is invaluable when an update breaks something.
+
+### Model Downloads
+
+Desktop 2.0 includes a built-in model download manager. When you add models through the ComfyUI Manager or workflow nodes, you can track download progress from the Downloads panel (accessible from the title bar or the bottom panel).
+
+## Data Locations
+
+Desktop 2.0 stores data in platform-specific locations:
+
+| Data | Windows Path |
+|------|-------------|
+| App data (settings, installations list) | `%APPDATA%\ComfyUI Desktop 2.0` |
+| Logs | `%APPDATA%\ComfyUI Desktop 2.0\logs` |
+| Default install directory | User-chosen during setup |
+
+## Updating Desktop 2.0
+
+Desktop 2.0 checks for updates automatically. You can also check manually from Global Settings. When an update is available, a notification will appear in the app.
+
+You can also download the latest version directly:
+
+- [Windows x64](https://dl.todesktop.com/241130tqe9q3y/windows/nsis/x64)
+- [Windows ARM64](https://dl.todesktop.com/241130tqe9q3y/windows/nsis/arm64)
+
+## Troubleshooting
+
+### Antivirus flags `uv.exe`
+
+Desktop 2.0 bundles [`uv`](https://github.com/astral-sh/uv) (from Astral) for Python environment management. Some antivirus products may flag `uv.exe` as malicious — this is a **known false positive**. If installation fails after an antivirus warning, add the ComfyUI installation directory to your antivirus whitelist and reinstall.
+
+### Installation fails with mirror errors
+
+If mirrors fail during installation, you'll see a red ❌ icon. Expand the mirror settings and configure a working mirror:
+- **Python Install Mirror** — Mirror for the Astral python-build-standalone project
+- **Pypi Install Mirror** — Mirror for pip packages
+- **Torch Install Mirror** — Mirror for PyTorch packages
+
+
+