Comfy Desktop on Linux

Comfy Desktop on Linux: install from the official .deb or AppImage, or clone the repo and run from source. Requires Ubuntu 22.04+, x64, and Node.js v22 LTS for a source build.

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: v22 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:

sudo apt install ./*.deb

For the AppImage:

chmod +x ./*.AppImage
./*.AppImage

If the app fails to launch, your distribution may be blocking Electron’s sandbox (Ubuntu 24.04+ restricts unprivileged user namespaces through AppArmor). In that case retry with --no-sandbox. Note that this flag disables Electron sandboxing for every process, so only use it when sandboxed launches fail.

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:

sudo apt install build-essential git

Then install Node.js 22 and enable pnpm:

nvm install 22 && nvm use 22
corepack enable

If you do not use nvm, install Node.js 22 from nodejs.org instead.

Clone and install

git clone https://github.com/Comfy-Org/Comfy-Desktop.git
cd Comfy-Desktop
pnpm run init

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

Start the app

./linux-dev.sh

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

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

git pull
pnpm run init
./linux-dev.sh

Optional: local package

To produce a local .deb or AppImage for yourself (not an official Comfy Org download):

pnpm run build:linux

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

Stopping the source checkout does not delete ComfyUI installations or app data. Delete these folders only if you want a complete cleanup:

Data	Default Location	Description
Installations	~/ComfyUI-Installs	Each ComfyUI installation you created (can also be deleted from within the app). Custom install paths are also not removed.
Shared models & outputs	~/ComfyUI-Shared	Shared model library, input/output directories
App config	~/.config/comfyui-desktop-2	Settings and installation records
App data	~/.local/share/comfyui-desktop-2	Persistent app data
Cache	~/.cache/comfyui-desktop-2	Download cache and other non-essential files
State	~/.local/state/comfyui-desktop-2	Runtime state such as port locks
Logs	~/.config/comfyui-desktop-2/logs	Desktop app logs (app.log)

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 those, run the repository’s reset-linux.sh script; it removes every known app data location but leaves your ~/ComfyUI-Installs untouched.