Local / Desktop troubleshooting

Last updated: October 13, 2026

This article covers common troubleshooting steps for ComfyUI Local and Desktop.

Q. ComfyUI isn’t starting or loading properly

Before trying advanced troubleshooting:

  • Restart ComfyUI

  • Refresh your browser

  • Confirm your system meets the recommended requirements

  • Check whether your installation is up to date

For full troubleshooting guidance:

πŸ‘‰ See Comfy Docs - Troubleshooting


Q. The Desktop app won't start after installation

Try the following depending on your operating system:

Windows

  • Try running the app as administrator once

macOS

  • If you see a security warning, go to System Settings β†’ Privacy & Security β†’ Open Anyway

Linux

  • Make sure fuse2 is installed

Also check whether you're using the latest Desktop version.

πŸ‘‰ Download Comfy


Q. Comfy Desktop closes by itself after an update (Windows)

On Windows, Comfy Desktop 1.0.46 and earlier can get stuck if an update download didn't finish. The app briefly shows an update screen, then closes without an error every time you open it. Because it closes before it can download the fix, it can't repair itself.

To recover, install the latest version manually:

  1. Download the latest Windows installer

  2. Run the installer. You don't need to uninstall the old version first.

  3. Open Comfy Desktop

Your installations, models, and settings are kept.

πŸ‘‰ Download Comfy Desktop for Windows

πŸ‘‰ See Comfy Docs - Desktop FAQ


Q. My GPU is not detected

Try the following:

  • Update your GPU drivers

  • Confirm your installation type supports GPU acceleration

  • Verify your hardware is supported

For troubleshooting steps:

πŸ‘‰ See Comfy Docs - Troubleshooting

For system requirements:

πŸ‘‰ See Comfy Docs - System Requirements


Q. An installation fails to update

Try:

  • Checking your internet connection

  • Creating a manual snapshot first

  • Restoring to a previous snapshot and retrying

If the issue continues:

πŸ‘‰ Comfy Docs - Troubleshooting


Q. How do I uninstall Comfy Desktop?

Comfy Desktop and its installations are stored separately.

To fully remove Comfy Desktop:

  1. Remove installations from inside the app (Right click β†’ Remove) or delete installation folders manually

  2. Uninstall the Desktop app using your operating system

Examples:

  • Windows β†’ Add / Remove Programs

  • macOS β†’ Move to Trash

  • Linux β†’ Use your package manager