Skip to main content
Comfy Desktop can run on Linux. Official .deb (Debian/Ubuntu) and AppImage packages are distributed through the Comfy Desktop repository. Download them with the universal download link, which auto-detects your platform. Most users should use one of those packages. If you want to run the app from source instead, clone the repository and follow the steps below.

System Requirements

  • OS: Linux (Ubuntu 22.04 or later recommended)
  • Architecture: x64
  • Node.js: v24 LTS or later (source build only)
  • pnpm: v10 or later, enabled with Corepack (source build only)
  • Build tools: build-essential and git (source build only)
  • GPU: A dedicated GPU (NVIDIA / AMD) is recommended, but not required
  • Disk Space: At least 4.85 GB recommended per ComfyUI installation

Install the official package

Download the Linux package with the universal download link (it auto-detects your platform), then install it:
The .deb package installs Comfy Desktop under /opt/Comfy Desktop and, during installation, adds an APT source for Comfy Desktop’s package repository, so later releases arrive through your system package manager. See Updating. When AppArmor is enabled and its parser accepts the bundled profile (Ubuntu 24.04 and later, where unprivileged user namespaces are restricted), the package also installs an AppArmor profile for the app at /etc/apparmor.d/comfyui-desktop-2. Electron’s sandbox therefore works on those systems without extra flags. Older distributions skip the profile because their AppArmor cannot load it, and the sandbox works there without it. Where unprivileged user namespaces do not work at all, the package marks its chrome-sandbox helper setuid instead. To check whether the profile was installed:
The package’s install scripts write the profile whenever the package is installed or upgraded. If you installed the .deb on Ubuntu 22.04 and later upgraded the system to 24.04, run the install scripts again:
For the AppImage, install FUSE 2 first. The AppImage loads libfuse.so.2, which Ubuntu does not install by default:
  • Ubuntu 24.04 and later: sudo apt install libfuse2t64
  • Ubuntu 22.04: sudo apt install libfuse2
Then make it executable and run it:
The AppImage runs no package install scripts, so it adds neither the AppArmor profile nor the APT source. Launching it from the app menu already passes --no-sandbox. If you start the file directly and it fails to launch, your distribution may be blocking Electron’s sandbox, so add the flag:
That flag disables Electron sandboxing for every process, so only use it when the sandboxed launch fails.

Build and run from source

These steps match the Development section in the repository README.

Prerequisites

Install the build tools and git first. A fresh Ubuntu install ships without them, and pnpm run init compiles native modules such as node-pty, which fails with Error: not found: make if build-essential is missing:
Then install Node.js 24 and enable pnpm:
The repository’s .nvmrc pins the exact version. If you do not use nvm, install Node.js 24 from nodejs.org instead.

Clone and install

pnpm run init installs dependencies and builds the bundled bootstrap Python.

Start the app

This starts Comfy Desktop in development mode. The script sets ELECTRON_DISABLE_SANDBOX=1 because Electron’s sandbox often fails in Linux dev environments.

Next Step: Using Comfy Desktop

Once the app is running, learn how to create instances, manage installations, and configure settings.

Updating

How Comfy Desktop updates depends on how you installed it.

.deb installs

Installing the .deb also adds an APT source (/etc/apt/sources.list.d/comfyui-desktop-2.sources) and an unattended-upgrades entry for it, so new releases arrive with your normal system updates:
You do not need to download the .deb again for each release. sudo apt remove comfyui-desktop-2 leaves the APT source on disk; sudo apt purge comfyui-desktop-2 removes it together with the unattended-upgrades entry.

AppImage

The AppImage updates itself: Comfy Desktop downloads the new build and replaces the .AppImage file you launched, so keep it in a folder your user account can write to. If the file sits in a read-only location, the update cannot replace it.

Source checkout

There is no in-app auto-update for a source checkout. Pull the latest code and start the app again:

Optional: local package

To produce a local .deb or AppImage for yourself (not an official Comfy Org download):
Artifacts land in dist/. If an AppImage fails because Chromium cannot create a sandbox, retry with --no-sandbox. That flag disables Electron sandboxing for every process.

Removing leftover data

Removing the app and removing your data are separate steps. Uninstall the app first:
  • .deb: sudo apt remove comfyui-desktop-2. The removal also deletes the AppArmor profile at /etc/apparmor.d/comfyui-desktop-2. Use sudo apt purge comfyui-desktop-2 to remove the APT source and the unattended-upgrades entry too.
  • AppImage: delete the .AppImage file.
Neither touches your ComfyUI installations or app data. Delete these folders only if you want a complete cleanup: To fully remove everything:
  1. Delete the clone of Comfy-Desktop
  2. Delete the config folder: ~/.config/comfyui-desktop-2
  3. Delete the data, cache, and state folders: ~/.local/share/comfyui-desktop-2, ~/.cache/comfyui-desktop-2, and ~/.local/state/comfyui-desktop-2
  4. Delete individual installations from within the app, or manually delete ~/ComfyUI-Installs plus any custom installation directories you configured
  5. Delete the shared model library at ~/ComfyUI-Shared (only if you no longer need these files)
Packaged installs (.deb or AppImage) also keep the app profile and logs in ~/.config/Comfy Desktop. To clear all of it, run the repository’s reset-linux.sh script. It deletes the app’s config, cache, data and state folders for the current build and for the earlier app names, and leaves ~/ComfyUI-Installs and ~/ComfyUI-Shared untouched. The installation list goes with them, so you may have to add your installations back with Add Existing Instance.