> ## 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에서 ComfyUI 인스턴스를 생성, 편집, 이름 변경, 삭제합니다
Comfy Desktop에서는 선택기 화면에서 여러 ComfyUI 인스턴스를 관리할 수 있습니다.
### 인스턴스 유형
Comfy Desktop은 네 가지 인스턴스 유형을 지원합니다. 각 유형은 카드와 제목 표시줄에 고유한 아이콘을 표시합니다.
| 유형 | 아이콘 | 설명 |
| -------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **독립형** | 💻 | Comfy Desktop이 생성한 자체 완비형 ComfyUI 인스턴스입니다. 번들 Python, 자동 업데이트, 전체 스냅샷 지원이 포함됩니다. **새 설치**를 클릭했을 때의 기본값입니다. |
| **클라우드** | ☁️ | Comfy Cloud 인스턴스입니다. Comfy Cloud 계정이 필요합니다. 클라우드 인스턴스는 Comfy 서버에서 실행되며 별도로 청구됩니다. |
| **원격** | 🌐 | 네트워크의 다른 컴퓨터에서 실행되는 ComfyUI 인스턴스에 연결합니다. 설정 중에 원격 호스트와 포트를 구성합니다. |
| **추적형** | — | 기존 ComfyUI 설치를 추적합니다(Git 클론 또는 포터블). **독립형**과 동일한 아이콘을 사용하며, 추적형 인스턴스를 위한 별도의 아이콘은 없습니다. 업데이트는 수동으로 관리합니다. [기존 설치 추적하기](#tracking-an-existing-installation)를 참조하세요. |
아래 이미지는 각 인스턴스 카드에서 사용할 수 있는 주요 작업을 표시합니다.
1. **새 설치**: 완전히 새로운 ComfyUI 인스턴스를 만듭니다. [새 인스턴스 생성하기](#creating-a-new-instance)를 참조하세요. [스냅샷 파일에서 인스턴스 생성하기](/ko/installation/desktop/usage/snapshots#create-an-instance-from-a-snapshot-file)도 가능합니다.
2. **⋮ 메뉴**: 세 점 아이콘을 클릭하여 인스턴스 작업 메뉴를 엽니다.
3. **관리**: 관리 패널을 열어 인스턴스를 구성합니다(경로, 실행 인자, 모델 디렉터리, 환경 변수). [관리](/ko/installation/desktop/usage/manage) 페이지를 참조하세요.
4. **스냅샷 복원**: 인스턴스를 이전 스냅샷으로 되돌립니다. [스냅샷](/ko/installation/desktop/usage/snapshots) 페이지를 참조하세요.
5. **공유**: 인스턴스의 스냅샷을 내보내 다른 사람과 공유합니다.
6. **설치 복사**: 기존 독립형 설치를 자체 Python 환경과 사용자 정의 노드를 포함하여 복제합니다. [설치 복사하기](#copying-an-installation)를 참조하세요.
7. **Forget**: 파일을 삭제하지 않고 선택기에서 인스턴스를 제거합니다(Untrack과 동일).
8. **Uninstall**: 인스턴스와 모든 파일을 디스크에서 영구히 삭제합니다.
Forget과 Uninstall에 대한 자세한 내용은 [인스턴스 제거하기](#uninstalling-an-instance)를 참조하세요.
## 새 인스턴스 생성하기
선택기 화면에서 **+** 카드(왼쪽 상단)를 클릭하여 새 ComfyUI 인스턴스를 추가합니다.
1. **설치 이름**: 인스턴스의 이름입니다. 기본값은 "ComfyUI"입니다.
2. **설치 위치**: ComfyUI를 설치할 위치를 선택합니다. Windows에서는 **SSD**를 사용하고 C: 드라이브의 루트를 피할 것을 강력히 권장합니다.
3. **고급**: 클릭하여 추가 옵션에 접근합니다.
4. **독립형**: 권장 옵션입니다. 번들 Python, 자동 업데이트, 스냅샷 지원이 포함된 자체 완비형 설치입니다.
5. **원격 연결**: 다른 컴퓨터에서 실행되는 ComfyUI 인스턴스에 연결합니다.
Comfy Desktop이 나머지 작업을 처리합니다: Python 다운로드, 환경 설정, ComfyUI 설치. 진행 화면에 현재 단계가 표시됩니다.
설치가 완료되면 Comfy Desktop에서 템플릿 라이브러리를 열어 시작할 워크플로 템플릿을 선택할 수 있습니다.
## 기존 설치 추적하기
이미 ComfyUI 설치가 있는 경우(Git 저장소에서 수동으로 설정했거나 포터블 버전으로 다운로드한 경우) 새로 만들지 않고 Comfy Desktop에 추가할 수 있습니다.
대시보드에서 **새 설치**를 클릭하여 설치 메뉴를 연 다음 **기존 설치 추가**를 선택합니다.
1. **새 설치**를 클릭하여 설치 옵션을 엽니다.
2. **기존 설치 추가**를 선택하여 추적 대화 상자를 엽니다.
### 설치 감지하기
추적 대화 상자에서 **찾아보기**를 클릭하여 ComfyUI 디렉터리를 선택합니다. Comfy Desktop이 폴더를 조사하여 설치 유형을 자동으로 감지합니다.
**Windows 포터블** 설치의 경우 다음과 같은 항목을 찾습니다.
* `standalone-env` 디렉터리 — 번들 Python 환경
* `ComfyUI/main.py` — ComfyUI 진입점
**수동으로 클론한 Git 저장소**의 경우 다음과 같은 항목을 찾습니다.
* `models/` 및 `user/` 디렉터리 — 구성된 ComfyUI의 흔적
* `.venv` 디렉터리 — Python 가상 환경
### 경로 설정하기
디렉터리를 선택하면 대화 상자에 감지된 경로가 표시됩니다. 필요에 따라 조정할 수 있습니다.
1. **ComfyUI 디렉터리**: `main.py`가 포함된 ComfyUI 폴더 경로입니다. 포터블 설치의 경우 일반적으로 포터블 패키지 *내부*의 폴더입니다.
* 포터블 예: `D:\ComfyUI_windows_portable\ComfyUI`
2. **Python 환경**: Python 환경 폴더 경로입니다. Comfy Desktop이 자동으로 감지하며 필요에 따라 재정의할 수 있습니다.
* 포터블 예: `D:\ComfyUI_windows_portable\python_embeded`
* Git 저장소 예: `/.venv`
### 추적형 vs 독립형
**추적형**(기존 설치 추가) 설치와 **독립형** 설치의 주요 차이점은 업데이트 관리 방식입니다.
| 측면 | 추적형 (기존) | 독립형 |
| ---------- | -------------------------------------------- | -------------------- |
| **업데이트** | 자동 업데이트 없음 — Git을 통해 수동으로 ComfyUI 버전 관리 | 기본 제공 자동 업데이트 |
| **Python** | 기존 Python 환경 사용(`.venv`, `python_embeded` 등) | 번들 Python, 자동 의존성 관리 |
| **격리** | 기존 경로와 환경 공유 | 완전히 자체 완비된 격리 설치 |
| **스냅샷** | 지원 안 함 | 스냅샷 지원 가능 |
| **용도** | 이미 ComfyUI를 설정하고 사용자 정의한 경우 | 처음부터 새로 설치하는 경우 |
> **참고:** 추적형 설치는 `launchMode: 'external'`을 사용합니다 — Comfy Desktop이 기존 ComfyUI 프로세스를 내부 관리 없이 시작합니다. 현재 스냅샷은 Standalone 인스턴스에서만 지원됩니다.
## 인스턴스 제거하기
[↩ 개요로 돌아가기](#overview)
인스턴스를 제거할 때 파일을 유지할지 모두 삭제할지에 따라 세 점 메뉴에 두 가지 옵션이 제공됩니다.
1. **Forget / Untrack**: 파일을 삭제하지 않고 선택기 목록에서 인스턴스를 제거합니다. 설치 폴더와 모든 데이터는 디스크에 남습니다. 목록을 정리하고 싶지만 나중에 인스턴스가 다시 필요할 수 있을 때 사용하세요.
2. **Uninstall / Delete**: 설치와 모든 파일을 디스크에서 영구히 제거합니다. 공유 디렉터리의 모델 파일은 영향을 받지 않습니다.
메뉴에 표시되는 이름은 인스턴스 유형에 따라 다릅니다. 스탠드얼론 설치의 경우 **Forget**이 표시되고(로컬 설치이므로 untrack은 적용되지 않음), 수동으로 추가한 설치의 경우 **Untrack**이 표시됩니다. 둘 다 파일을 삭제하지 않고 목록에서 인스턴스를 제거하는 동일한 작업을 수행합니다.
## 설치 복사하기
[↩ 개요로 돌아가기](#overview)
기존 독립형 설치를 복제하려면 해당 카드를 마우스 오른쪽 버튼으로 클릭하고 **설치 복사**를 선택합니다. 이렇게 하면 다음 사항이 포함된 복사본이 생성됩니다.
* 새로운 Python 환경
* 동일한 ComfyUI 버전
* 자체 사용자 정의 노드 설정
복사가 시작되기 전에 새 설치의 이름을 입력하라는 메시지가 표시됩니다.
## 인스턴스 편집하기
[↩ 개요로 돌아가기](#overview)
인스턴스의 **관리** 패널에서 다음을 수행할 수 있습니다.
* 설치 경로 변경
* 실행 인자 조정
* 모델 디렉터리 수정
* 환경 변수 업데이트
인스턴스 카드를 마우스 오른쪽 버튼으로 클릭하고 **관리**를 선택하여 **관리** 패널을 엽니다.
## 오류 상태
설치에 문제가 발생하면 카드에 경고 표시기가 나타납니다. 카드를 마우스 오른쪽 버튼으로 클릭하고 **오류 해제**를 선택하여 오류 상태를 지웁니다. 문제가 지속되면 [데이터 위치](/ko/installation/desktop/usage/settings#data-locations)에서 로그를 확인하세요.