Skip to main content

​
General Questions

Comfy Desktop is a complete rewrite that acts as a multi-installation manager. Unlike Legacy Desktop which was a single-install application, Comfy Desktop lets you install, manage, and run multiple ComfyUI versions side by side. It also adds snapshots and model download management.For users of Legacy Desktop, check the Migration Guide to transfer your existing setup.
Yes. The source is on GitHub. Comfy Desktop is dual-licensed: AGPL-3.0-or-later, or a commercial license from Comfy Org (licensing@comfy.org).
Comfy Desktop is one of several installation options. You can still use the Portable (Windows) install, Manual Install, or Comfy Cloud depending on your needs. Desktop is recommended for most users due to its ease of use and features like one-click updates and snapshot management.
No. Comfy Desktop checks for a new version shortly after it launches and then every 10 minutes, and that check has no off switch. The only update setting is Automatically install Desktop updates in Desktop Settings → Updates, and it is on by default.
  • On: a new version downloads in the background and installs without asking. The title bar shows Downloading update… while it downloads, then Desktop Update Ready when the update is ready to apply.
  • Off: Comfy Desktop still checks and still tells you, but it stops downloading on its own. The title bar shows a Desktop Update pill instead, and clicking it downloads the update and offers to restart.
The ComfyUI version inside an instance is updated separately. Use the instance’s Update tab and pick the Stable or Latest on GitHub channel there.On Linux, the in-app updater does not apply to .deb installs. Download the new package with the universal download link and install it with sudo apt install ./*.deb.

​
Installation & Setup

See system requirements for full details.
  • Windows: Windows 10+, x64 or ARM64. A dedicated GPU (NVIDIA / AMD) is recommended, but not required.
  • macOS: macOS 13+ (Ventura), Apple Silicon (M1+)
  • Linux: Official .deb and AppImage packages are distributed through the Comfy Desktop repository. A dedicated GPU is recommended.
  • Disk: At least 4.85 GB per standalone installation
  • RAM: 8 GB minimum, 16 GB recommended
On Windows, the standalone installation does not require admin rights. On macOS, you’ll need admin rights for the initial system-wide installation. On Linux, installing the .deb package requires sudo; the AppImage runs in user space without admin rights.
Download the latest Windows or macOS build from the official ComfyUI Download page. On Linux, download the .deb or AppImage with the universal download link from the Comfy Desktop repository. To run from source instead, see the Linux install guide.
Yes, they can coexist. However, we recommend migrating your installations to the new Comfy Desktop and eventually uninstalling Legacy Desktop. See the Migration Guide.

​
Usage

On the Dashboard, click New Instance to create a standalone instance, or open New Instance and choose Add Existing Instance to track a git clone or Windows portable install. Use the Comfy Cloud card to connect to Cloud.
  • Standalone: Fresh install with bundled Python
  • Add Existing Instance: Track a git clone or portable install
  • Cloud: Connect to Comfy Cloud
Yes! Comfy Desktop is designed for this. Each installation runs in its own isolated environment with its own Python and dependencies. You can launch them simultaneously in separate windows.
Models are shared across instances by default. Configure shared folders in Desktop Settings → Storage.
  • Standalone: The install itself lives in its installation folder. Custom nodes and the Python environment are per-install. Models usually come from the shared model directories.
  • Git clone / portable (tracked): Data stays in that existing folder (models/, custom_nodes/, user/). You can still opt into shared models, input, and output.
Comfy Desktop creates snapshots automatically on key events: every boot and restart, before and after an update, and after a restore. A snapshot records the instance’s ComfyUI version, custom nodes with their versions, and all pip packages in the environment. Model files, inputs, and outputs are not part of a snapshot.You can browse, restore, export, and share snapshots from the instance’s Snapshots tab. See Snapshots.

​
How to Stop/Exit Comfy Desktop

To stop a running ComfyUI instance (stop the Python backend while keeping the app open):
  1. Click the ⋮ (kebab) menu on the instance card
  2. Select Stop
  3. Confirm in the dialog
This stops the ComfyUI Python process but leaves the desktop app window open so you can relaunch anytime. To fully quit the desktop app, open the ☰ menu in the top-left corner and select Quit Desktop (or use the equivalent OS quit command). Closing the last window returns to the Dashboard unless you quit the app.

​
Troubleshooting

  1. Windows: Try running as administrator once
  2. macOS: If you see a security warning, go to System Settings → Privacy & Security and click Open Anyway
  3. Linux: Make sure FUSE 2 is installed (sudo apt install libfuse2)
  4. Check the Downloads page for the latest version
On Windows, Comfy Desktop 1.0.46 and earlier can get stuck if an update download did not finish. The app briefly shows an update screen, then closes without an error. This repeats on every launch, and the app closes before it can download the fix. Version 1.0.47 and later fix this.To recover, install the latest version manually:
  1. Download the latest Windows installer, or get it from the Download page.
  2. Run the installer. You don’t need to uninstall the old version first.
  3. Launch Comfy Desktop.
Your installations, models, and settings are kept.
  • Ensure your NVIDIA drivers are up to date
  • On Linux, verify CUDA toolkit is installed
  • Check that the installation type supports GPU (Standalone and Git Clone do; Cloud connections use remote GPU)
  • Check your internet connection
  • Create a manual snapshot from the instance’s Snapshots tab before retrying
  • If the issue persists, restore to a previous snapshot and try again
During New Instance, Comfy Desktop checks free space on the install drive. Low Disk Space is a warning — select Continue Anyway to proceed, or choose another path. Not Enough Space for Template Models blocks that template; pick a lighter workflow or free space. Very small disks may skip the template step. See Creating a New Instance.
The Desktop app writes a rotating app.log file. The fastest way to find it is Desktop Settings → Logs → Diagnostics → Open logs folder (☰ menu in the top-left).Default log folders:
  • Windows: %APPDATA%\Comfy Desktop\logs
  • macOS: ~/Library/Logs/Comfy Desktop
  • Linux: ~/.config/Comfy Desktop/logs
Look for app.log. Previous sessions rotate to timestamped app.log_*.log files.For ComfyUI process output (not the Desktop app itself), open the instance Manage panel and use the Terminal tab. See Manage.
ComfyUI does not natively integrate with Ollama for diffusion model backends. However, you can use Ollama-served LLMs for prompt generation and text processing through custom nodes available in the ComfyUI Manager registry.For connecting ComfyUI to LLM services, see Install Custom Nodes.
Comfy Desktop and its installations are separate on disk. To uninstall the app and its installations:
  1. Delete the installations from within the app (right-click → Remove) or delete the installation folders manually
  2. Uninstall the app using your system’s standard method (Add/Remove Programs on Windows, drag to Trash on macOS, package manager on Linux)
That does not delete app settings, logs, shared models, or outputs. For leftover folders and a complete cleanup, see Windows, macOS, or Linux.
No. Comfy Desktop is designed as a local GUI application and does not support headless, server-only, or remote operation modes. It requires a graphical desktop environment to launch and manage ComfyUI instances.For headless or server deployments, use a manual ComfyUI installation or the Windows Portable build instead.