Skip to main content
Comfy Desktop is a multi-installation manager that lets you run multiple ComfyUI instances from a single launcher. This guide covers how to install and uninstall Comfy Desktop on macOS.

System Requirements

  • OS: macOS 13 (Ventura) or later
  • Hardware: Apple Silicon (M1 or later)
  • Disk Space: At least 4.85 GB recommended per installation

Download Comfy Desktop

Download the latest installer for macOS. The page will automatically detect your platform.

Installation

  1. Open the downloaded .dmg file
  2. Drag Comfy Desktop into the Applications folder
  3. Launch it from Launchpad or Spotlight
Desktop MacOS The first time you launch, macOS may show a security warning. Go to System Settings → Privacy & Security and click Open Anyway to allow it.
Already using Legacy Desktop? Comfy Desktop can automatically detect and migrate your existing installation. Your custom nodes, workflows, models, and settings are carried over, and Comfy Desktop backs up your legacy state before it starts. The migration reuses your existing data folder and Python environment in place, so back them up yourself if you need a pristine copy.Learn more in the Migrate from Legacy guide.

Next Step: Using Comfy Desktop

Once installed, learn how to create instances, manage installations, and configure settings.

Updating Comfy Desktop

Comfy Desktop checks for updates a moment after it starts and every 10 minutes while it runs, and each check downloads what it finds. Neither can be turned off. The only setting controls whether an update then installs without asking.

Automatic updates

Automatically install Desktop updates is on by default. The title bar follows the download: Downloading update… first, then Desktop Update Ready. With the setting on, Comfy Desktop applies the update without asking: when you quit the app on macOS, at the next launch on Windows. Click the pill to restart into it right away instead. Restart & Update quits Comfy Desktop and reopens the new version, so anything running in the app closes with it. Later closes the prompt and leaves the update to apply on its own — that automatic apply only happens while this setting is on.

Manual update

  1. Click ☰ and choose Desktop Settings.
  2. Open the Updates tab.
The card leads with the state, such as Comfy Desktop is up to date or Update v1.2.0 ready to install, followed by the installed version, the last check, and the latest version when a newer one exists. The main button follows that state: Check for updates, Download, or Restart & Update. While a download runs, clicking the title bar pill opens Desktop Settings, and the Updates tab shows the progress. Desktop Settings with the Updates tab open, showing the up-to-date state, the installed version and the automatic install toggle Turn off Automatically install Desktop updates and nothing installs on its own. The title bar shows Desktop Update and the Updates card shows Update … available. The file still downloads; when it is ready, click the Desktop Update Ready pill and choose Restart & Update.

Uninstalling

Remove Comfy Desktop

  1. Open Applications folder in Finder
  2. Right-click Comfy Desktop and select Move to Trash
Uninstall Comfy Desktop on macOS

What Uninstalling the App Does NOT Remove

Uninstalling Comfy Desktop only removes the launcher app itself. The following data is not removed and must be deleted manually if you want a complete cleanup:
The directories listed above contain your personal ComfyUI data (models, outputs, settings, and installations). They are not Comfy Desktop application files. Deleting them will permanently remove your data.
To fully remove everything:
  1. Delete the app data folder: ~/Library/Application Support/Comfy Desktop
  2. Delete the logs folder: ~/Library/Logs/Comfy Desktop
  3. Delete individual installations from within the app, or manually delete ~/ComfyUI-Installs plus any custom installation directories you configured
  4. Delete the shared model library at ~/ComfyUI-Shared (only if you no longer need these files)

If Comfy Desktop Starts Up Broken

A manual update can leave Comfy Desktop launching with no styling, missing translations, or buttons and dropdowns that do nothing. The usual cause is a Chromium profile or a cached pending update left behind by the previous version. Quit Comfy Desktop first, then run the reset script from the Comfy-Desktop repository:
The script lists every path it is about to delete and asks before deleting anything. It clears the app’s settings, caches, and Chromium profile for the current version and for the earlier app names, so a profile left by an older build cannot come back. It refuses to run while Comfy Desktop is open. Because the log folder is one of the paths it deletes, copy the log out first if you may need to report the problem, see Where the App Log Is. Your ComfyUI installations in ~/ComfyUI-Installs and your shared models in ~/ComfyUI-Shared stay on disk, but the file that lists the installations is deleted with the rest of the app data, so you may have to add them back with Add Existing Instance on the next launch. The script also reports any extra copies of the app it finds on the Mac without deleting them, because a second copy in the Dock is a common reason a reset seems to change nothing.

Where the App Log Is

If the reset does not fix the problem and you want to report it on the Comfy-Desktop issue tracker, the file to attach is app.log in ~/Library/Logs/Comfy Desktop. That folder is one of the paths the reset deletes, so copy it somewhere else before you run the script. Comfy Desktop writes a new app.log at each launch and keeps the 50 most recent earlier files beside it as app.log_<timestamp>.log, so pick the file from the session that failed. Each file rotates once it reaches 5 MB, so a long session can span more than one file.