Skip to content

Add warning about /resource/ComfyUI folder in Desktop docs #609

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Dec 1, 2025
Merged

Add warning about /resource/ComfyUI folder in Desktop docs #609

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
17f14af
Update snippets/install/desktop-resource-warning.mdx
mintlify[bot] Dec 1, 2025
2578ff4
Update snippets/zh/install/desktop-resource-warning.mdx
mintlify[bot] Dec 1, 2025
95bc875
Update installation/desktop/windows.mdx
mintlify[bot] Dec 1, 2025
52f0d71
Update installation/desktop/macos.mdx
mintlify[bot] Dec 1, 2025
9202bb6
Update zh-CN/installation/desktop/windows.mdx
mintlify[bot] Dec 1, 2025
a19bfc3
Update zh-CN/installation/desktop/macos.mdx
mintlify[bot] Dec 1, 2025
fb43088
Update installation/desktop/windows.mdx
mintlify[bot] Dec 1, 2025
c1f2576
Update installation/desktop/macos.mdx
mintlify[bot] Dec 1, 2025
22b8269
Update zh-CN/installation/desktop/windows.mdx
mintlify[bot] Dec 1, 2025
2589d97
Update zh-CN/installation/desktop/macos.mdx
mintlify[bot] Dec 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions installation/desktop/macos.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ import TroubleshootingFeedback from "/snippets/install/troubleshooting-feedback.
import ExternalModelsDesktop from "/snippets/install/external-models-desktop.mdx"
import DesktopVenv from "/snippets/install/desktop-venv.mdx"
import AddExternalModels from "/snippets/install/add-external-models.mdx"
import DesktopResourceWarning from "/snippets/install/desktop-resource-warning.mdx"

**ComfyUI Desktop** is a standalone installation version that can be installed like regular software.
It supports quick installation and automatic configuration of the **Python environment and dependencies**, and supports one-click import of existing ComfyUI settings, models, workflows, and files.
Expand Down Expand Up @@ -126,6 +127,7 @@ Then find the **ComfyUI icon** in **Launchpad** and click it to enter ComfyUI in
</Step>
</Steps>

<DesktopResourceWarning/>
<FirstGeneration/>
<UpdateComfyui/>
<AddExternalModels/>
Expand Down
2 changes: 2 additions & 0 deletions installation/desktop/windows.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ import TroubleshootingFeedback from "/snippets/install/troubleshooting-feedback.
import ExternalModelsDesktop from "/snippets/install/external-models-desktop.mdx"
import DesktopVenv from "/snippets/install/desktop-venv.mdx"
import AddExternalModels from "/snippets/install/add-external-models.mdx"
import DesktopResourceWarning from "/snippets/install/desktop-resource-warning.mdx"

**ComfyUI Desktop** is a standalone installation version that can be installed like regular software. It supports quick installation and automatic configuration of the **Python environment and dependencies**, and supports one-click import of existing ComfyUI settings, models, workflows, and files. You can quickly migrate from an existing [ComfyUI Portable version](/installation/comfyui_portable_windows) to the Desktop version.

Expand Down Expand Up @@ -117,6 +118,7 @@ Double-click the corresponding shortcut to enter ComfyUI initialization settings
</Step>
</Steps>

<DesktopResourceWarning/>
<FirstGeneration/>
<UpdateComfyui/>
<AddExternalModels/>
Expand Down
7 changes: 7 additions & 0 deletions snippets/install/desktop-resource-warning.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
## Important: Do not modify the resource/ComfyUI folder

<Warning>
Do not add or modify any content in the `/resource/ComfyUI` folder. All content in this folder will be reset when ComfyUI Desktop updates.

Unlike other ComfyUI versions, the Desktop version manages this folder automatically. During installation, you chose a custom location for your models, custom nodes, and other user files - please use that location instead.
</Warning>
7 changes: 7 additions & 0 deletions snippets/zh/install/desktop-resource-warning.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
## 重要提示：请勿修改 resource/ComfyUI 文件夹

<Warning>
请勿在 `/resource/ComfyUI` 文件夹中添加或修改任何内容。此文件夹中的所有内容将在 ComfyUI 桌面版更新时被重置。

与其他 ComfyUI 版本不同，桌面版会自动管理此文件夹。在安装过程中，你已选择了模型、自定义节点和其他用户文件的自定义存储位置，请使用该位置存放你的文件。
</Warning>
2 changes: 2 additions & 0 deletions zh-CN/installation/desktop/macos.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ import TroubleshootingFeedback from "/snippets/zh/install/troubleshooting-feedba
import ExternalModelsDesktop from "/snippets/zh/install/external-models-desktop.mdx"
import DesktopVenv from "/snippets/zh/install/desktop-venv.mdx"
import AddExternalModels from "/snippets/zh/install/add-external-models.mdx"
import DesktopResourceWarning from "/snippets/zh/install/desktop-resource-warning.mdx"

**ComfyUI 桌面版（Desktop）** 是一个独立的安装版本，可以像常规软件一样安装，支持快捷安装、自动配置 **Python 环境及依赖**，并支持导入已有的 ComfyUI 设置、模型、工作流和文件。

Expand Down Expand Up @@ -113,6 +114,7 @@ brew install comfyui
</Step>
</Steps>

<DesktopResourceWarning/>
<FirstGeneration/>
<UpdateComfyui/>
<AddExternalModels/>
Expand Down
2 changes: 2 additions & 0 deletions zh-CN/installation/desktop/windows.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ import TroubleshootingFeedback from "/snippets/zh/install/troubleshooting-feedba
import ExternalModelsDesktop from "/snippets/zh/install/external-models-desktop.mdx"
import DesktopVenv from "/snippets/zh/install/desktop-venv.mdx"
import AddExternalModels from "/snippets/zh/install/add-external-models.mdx"
import DesktopResourceWarning from "/snippets/zh/install/desktop-resource-warning.mdx"

**ComfyUI 桌面版（Desktop）** 是一个独立的安装版本，可以像常规软件一样进行安装，支持快捷安装自动配置 **Python环境及依赖** ，支持导入已有的 ComfyUI 设置、模型、工作流和文件，可以快速从已有的[ComfyUI 便携版](/zh-CN/installation/comfyui_portable_windows)迁移到桌面版

Expand Down Expand Up @@ -111,6 +112,7 @@ ComfyUI 桌面版(Windows)硬件要求：
</Step>
</Steps>

<DesktopResourceWarning/>
<FirstGeneration/>
<UpdateComfyui/>
<AddExternalModels/>
Expand Down