> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Desktop en Linux

> Instala Comfy Desktop en Linux usando los paquetes oficiales .deb o AppImage. Las compilaciones desde el código fuente requieren Ubuntu 22.04 o superior, x64 y Node.js v22 LTS.

**Comfy Desktop** puede ejecutarse en Linux. Los paquetes oficiales `.deb` (Debian/Ubuntu) y AppImage se distribuyen a través del [repositorio de Comfy Desktop](https://github.com/Comfy-Org/Comfy-Desktop). Descárgalos con el [enlace de descarga universal](https://dl.todesktop.com/241130tqe9q3y), que detecta tu plataforma automáticamente. La mayoría de los usuarios deberían usar uno de esos paquetes. Si en cambio prefieres ejecutar la aplicación desde la fuente, clona el repositorio y sigue los pasos a continuación.

## Requisitos del sistema

* **SO:** Linux (se recomienda Ubuntu 22.04 o posterior)
* **Arquitectura:** x64
* **Node.js:** v22 LTS o posterior (solo compilación desde el código fuente)
* **pnpm:** v10 o posterior, habilitado con Corepack (solo compilación desde el código fuente)
* **Herramientas de compilación:** `build-essential` y `git` (solo compilación desde el código fuente)
* **GPU:** Se recomienda una GPU dedicada (NVIDIA / AMD), pero no es obligatoria
* **Espacio en disco:** Se recomiendan al menos 4.85 GB por cada instalación de ComfyUI

## Instalar el paquete oficial

Descarga el paquete para Linux con el [enlace de descarga universal](https://dl.todesktop.com/241130tqe9q3y) (detecta tu plataforma automáticamente) y luego instálalo:

```bash theme={null}
sudo apt install ./*.deb
```

Para el AppImage:

```bash theme={null}
chmod +x ./*.AppImage
./*.AppImage
```

Si la aplicación no logra iniciarse, es posible que tu distribución esté bloqueando el sandbox de Electron (Ubuntu 24.04+ restringe los espacios de nombres de usuario sin privilegios mediante AppArmor). En ese caso, reintenta con `--no-sandbox`. Ten en cuenta que esta marca desactiva el sandbox de Electron para todos los procesos, así que úsala solo cuando fallen los inicios con sandbox.

## Compilar y ejecutar desde el código fuente

Estos pasos coinciden con la sección [Development](https://github.com/Comfy-Org/Comfy-Desktop#development) del README del repositorio.

### Requisitos previos

Primero instala las herramientas de compilación y git. Una instalación reciente de Ubuntu no las incluye, y `pnpm run init` compila módulos nativos como `node-pty`, lo que falla con `Error: not found: make` si falta `build-essential`:

```bash theme={null}
sudo apt install build-essential git
```

Luego instala Node.js 22 y habilita pnpm:

```bash theme={null}
nvm install 22 && nvm use 22
corepack enable
```

Si no usas nvm, instala Node.js 22 desde [nodejs.org](https://nodejs.org/) en su lugar.

### Clonar e instalar

```bash theme={null}
git clone https://github.com/Comfy-Org/Comfy-Desktop.git
cd Comfy-Desktop
pnpm run init
```

`pnpm run init` instala las dependencias y compila el bootstrap de Python incluido.

### Inicia la aplicación

```bash theme={null}
./linux-dev.sh
```

Esto inicia Comfy Desktop en modo de desarrollo. El script establece `ELECTRON_DISABLE_SANDBOX=1` porque el sandbox de Electron suele fallar en entornos de desarrollo de Linux.

> **[Siguiente paso: usar Comfy Desktop](https://docs.comfy.org/es/installation/desktop/usage/overview.md)**
>
> Una vez que la aplicación esté en ejecución, aprende a crear instancias, administrar instalaciones y configurar los ajustes.

## Actualizar

No hay actualización automática dentro de la aplicación para una instalación desde el código fuente. Obtén el código más reciente y vuelve a iniciar la aplicación:

```bash theme={null}
git pull
pnpm run init
./linux-dev.sh
```

## Opcional: paquete local

Para generar un `.deb` local o un AppImage para ti (no es una descarga oficial de Comfy Org):

```bash theme={null}
pnpm run build:linux
```

Los artefactos se generan en `dist/`. Si un AppImage falla porque Chromium no puede crear un sandbox, reintenta con `--no-sandbox`. Esa opción desactiva el sandbox de Electron para todos los procesos.

## Eliminar datos residuales

Detener el checkout de la fuente no elimina las instalaciones de ComfyUI ni los datos de la aplicación. Elimina estas carpetas solo si deseas una limpieza completa:

| Datos | Ubicación predeterminada | Descripción |
| - | - | - |
| Instalaciones | `~/ComfyUI-Installs` | Cada instalación de ComfyUI que creaste (también se puede eliminar desde dentro de la aplicación). Las rutas de instalación personalizadas tampoco se eliminan. |
| Modelos y salidas compartidos | `~/ComfyUI-Shared` | Biblioteca de modelos compartida, directorios de entrada/salida |
| Configuración de la aplicación | `~/.config/comfyui-desktop-2` | Configuraciones y registros de instalación |
| Datos de la aplicación | `~/.local/share/comfyui-desktop-2` | Datos persistentes de la aplicación |
| Caché | `~/.cache/comfyui-desktop-2` | Caché de descargas y otros archivos no esenciales |
| Estado | `~/.local/state/comfyui-desktop-2` | Estado en tiempo de ejecución, como los bloqueos de puertos |
| Registros | `~/.config/comfyui-desktop-2/logs` | Registros de la aplicación de escritorio (`app.log`) |

Para eliminar todo por completo:

1. **Elimina el clon** de `Comfy-Desktop`
2. **Elimina la carpeta de configuración**: `~/.config/comfyui-desktop-2`
3. **Elimina las carpetas de datos, caché y estado**: `~/.local/share/comfyui-desktop-2`, `~/.cache/comfyui-desktop-2` y `~/.local/state/comfyui-desktop-2`
4. **Elimina las instalaciones individuales** desde dentro de la aplicación, o elimina manualmente `~/ComfyUI-Installs` junto con cualquier directorio de instalación personalizado que hayas configurado
5. **Elimina la biblioteca de modelos compartida** en `~/ComfyUI-Shared` (solo si ya no necesitas estos archivos)

Las instalaciones empaquetadas (`.deb` o AppImage) también guardan el perfil y los registros de la aplicación en `~/.config/Comfy Desktop`. Para limpiarlos, ejecuta el script [reset-linux.sh](https://github.com/Comfy-Org/Comfy-Desktop/blob/main/scripts/reset-linux.sh) del repositorio; elimina todas las ubicaciones de datos conocidas de la aplicación, pero deja intacta tu `~/ComfyUI-Installs`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.