> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-d5155ac.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux: Comfy Desktop

> Linux에서 소스로부터 Comfy Desktop을 빌드하고 실행하기

**Comfy Desktop**은 Linux에서 실행할 수 있지만, 아직 공식 Linux 설치 프로그램은 없습니다. [다운로드 페이지](https://comfy.org/download)는 Windows와 macOS만 제공합니다. Linux에서는 [Comfy Desktop 저장소](https://github.com/Comfy-Org/Comfy-Desktop)를 클론한 뒤 소스에서 실행하세요.

## 시스템 요구 사항

* **OS:** Linux (Ubuntu 22.04 이상 권장)
* **아키텍처:** x64
* **Node.js:** v22 LTS 이상
* **pnpm:** v10 이상 (Corepack으로 활성화)
* **GPU:** 전용 GPU(NVIDIA / AMD)를 권장하지만 필수는 아닙니다
* **디스크 공간:** ComfyUI 설치마다 최소 4.85 GB 권장

## 소스에서 빌드하고 실행

이 단계는 저장소 README의 [Development](https://github.com/Comfy-Org/Comfy-Desktop#development) 섹션과 같습니다.

### 사전 요구 사항

Node.js 22를 설치한 다음 pnpm을 활성화하세요:

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

nvm을 쓰지 않는다면 [nodejs.org](https://nodejs.org/)에서 Node.js 22를 설치하세요.

### 클론 및 설치

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

`pnpm run init`은 의존성을 설치하고 번들된 bootstrap Python을 빌드합니다.

### 앱 시작

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

개발 모드로 Comfy Desktop을 시작합니다. 스크립트는 `ELECTRON_DISABLE_SANDBOX=1`을 설정합니다. Linux 개발 환경에서는 Electron 샌드박스가 자주 실패하기 때문입니다.

<Card title="다음 단계: Comfy Desktop 사용" icon="book-open" href="/ko/installation/desktop/usage/overview">
  앱이 실행되면 인스턴스 생성, 설치 관리, 설정 구성 방법을 알아보세요.
</Card>

## 업데이트

소스 체크아웃에는 앱 내 자동 업데이트가 없습니다. 최신 코드를 pull한 뒤 다시 시작하세요:

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

## 선택 사항: 로컬 패키지

직접 `.deb` 또는 AppImage를 만들려면 (Comfy Org 공식 다운로드가 아님):

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

산출물은 `dist/`에 생성됩니다. Chromium이 샌드박스를 만들지 못해 AppImage가 실패하면 `--no-sandbox`로 다시 시도하세요. 이 플래그는 모든 프로세스의 Electron 샌드박스를 끕니다.

## 남은 데이터 삭제

소스 실행을 멈춰도 ComfyUI 설치와 앱 데이터는 삭제되지 않습니다. 완전히 정리하려면 다음 폴더만 삭제하세요:

| 데이터        | 기본 위치                              | 설명                                                       |
| ---------- | ---------------------------------- | -------------------------------------------------------- |
| 설치         | `~/ComfyUI-Installs`               | 생성한 각 ComfyUI 설치(앱 내에서도 삭제 가능). 사용자 지정 설치 경로도 제거되지 않습니다. |
| 공유 모델 및 출력 | `~/ComfyUI-Shared`                 | 공유 모델 라이브러리, 입력/출력 디렉토리                                  |
| 앱 설정       | `~/.config/comfyui-desktop-2`      | 설정 및 설치 기록                                               |
| 앱 데이터      | `~/.local/share/comfyui-desktop-2` | 지속 앱 데이터                                                 |
| 캐시         | `~/.cache/comfyui-desktop-2`       | 다운로드 캐시 및 기타 비필수 파일                                      |
| 상태         | `~/.local/state/comfyui-desktop-2` | 포트 잠금 같은 런타임 상태                                          |
| 로그         | `~/.config/comfyui-desktop-2/logs` | 데스크톱 앱 로그(`app.log`)                                     |

모든 항목을 완전히 제거하려면:

1. **`Comfy-Desktop` 클론 삭제**
2. **설정 폴더 삭제**: `~/.config/comfyui-desktop-2`
3. **데이터, 캐시, 상태 폴더 삭제**: `~/.local/share/comfyui-desktop-2`, `~/.cache/comfyui-desktop-2`, `~/.local/state/comfyui-desktop-2`
4. **개별 설치 삭제**: 앱 내에서 삭제하거나 `~/ComfyUI-Installs`와 직접 설정한 사용자 지정 설치 디렉토리를 수동으로 삭제하세요.
5. **공유 모델 라이브러리 삭제**: `~/ComfyUI-Shared`를 삭제하세요(해당 파일이 더 이상 필요하지 않은 경우).