.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-essentialandgit(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:.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:
.deb on Ubuntu 22.04 and later upgraded the system to 24.04, run the install scripts again:
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
--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:
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, andpnpm run init compiles native modules such as node-pty, which fails with Error: not found: make if build-essential is missing:
.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
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:
.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):
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. Usesudo apt purge comfyui-desktop-2to remove the APT source and the unattended-upgrades entry too.- AppImage: delete the
.AppImagefile.
To fully remove everything:
- Delete the clone of
Comfy-Desktop - Delete the config folder:
~/.config/comfyui-desktop-2 - Delete the data, cache, and state folders:
~/.local/share/comfyui-desktop-2,~/.cache/comfyui-desktop-2, and~/.local/state/comfyui-desktop-2 - Delete individual installations from within the app, or manually delete
~/ComfyUI-Installsplus any custom installation directories you configured - Delete the shared model library at
~/ComfyUI-Shared(only if you no longer need these files)
.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.