Skip to content

Commit b557d5f

Browse files
Add backup warning for ComfyUI portable update script (#519)
* Update installation/update_comfyui.mdx * Update installation/update_comfyui.mdx * Update zh-CN/installation/update_comfyui.mdx * Update installation/update_comfyui.mdx * Update zh-CN/installation/update_comfyui.mdx --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
1 parent b9c3707 commit b557d5f

File tree

2 files changed

+51
-3
lines changed

2 files changed

+51
-3
lines changed

installation/update_comfyui.mdx

Lines changed: 26 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,33 @@ While we've covered ComfyUI updates across different installation methods in var
2525
├── update.py
2626
├── update_comfyui.bat // Update to latest development version
2727
├── update_comfyui_stable.bat // Update to latest stable version
28-
└── update_comfyui_and_python_dependencies.bat // Update dependencies (for troubleshooting)
28+
└── update_comfyui_and_python_dependencies.bat // ⚠️ DANGER: Reinstalls dependencies - may cause conflicts
2929
```
30-
<Warning>Ensure a stable internet connection during updates. Users in mainland China may need to configure a proxy to access GitHub repositories reliably.</Warning>
30+
<Warning>Ensure a stable internet connection during updates.</Warning>
31+
32+
<Warning>
33+
**⚠️ DANGER: Use `update_comfyui_and_python_dependencies.bat` with extreme caution!**
34+
35+
This script is more thorough than regular updates and will:
36+
- ✅ Update ComfyUI code itself
37+
- ✅ Update PyTorch (for NVIDIA GPU CUDA 12.9)
38+
- ✅ Reinstall ALL Python dependencies
39+
40+
**Risks:**
41+
- May cause dependency conflicts with your existing setup
42+
- Can break custom nodes that rely on specific package versions
43+
- May overwrite manually configured packages
44+
45+
**⚠️ Only use this script when:**
46+
- You need to fix dependency issues
47+
- Performing major version updates
48+
- For daily updates, use `update_comfyui.bat` instead
49+
50+
**Before running this script:**
51+
1. **Back up your entire ComfyUI installation**
52+
2. Document any custom package versions you've installed
53+
3. Be prepared to reinstall custom nodes if needed
54+
</Warning>
3155
</Tab>
3256
<Tab title="Desktop">
3357
ComfyUI Desktop features automatic updates to ensure you're always running the latest version. However, since the Desktop version is built on stable releases, feature updates may lag behind. You can also visit the [download page](https://www.comfy.org/download) to get the latest version.

zh-CN/installation/update_comfyui.mdx

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,33 @@ import UpdateRequirement from "/snippets/zh/install/update-requirement.mdx"
2525
├── update.py
2626
├── update_comfyui.bat // 更新到最新开发版本
2727
├── update_comfyui_stable.bat // 更新到最新稳定版本
28-
└── update_comfyui_and_python_dependencies.bat // 更新依赖(问题修复时使用)
28+
└── update_comfyui_and_python_dependencies.bat // ⚠️ 危险:重装依赖 - 可能导致冲突
2929
```
3030
<Warning>更新过程中请保持网络连接稳定,如果在中国大陆地区可能需要配置网络代理来保证能够顺利访问 GitHub 仓库</Warning>
31+
32+
<Warning>
33+
**⚠️ 危险:请谨慎使用 `update_comfyui_and_python_dependencies.bat`**
34+
35+
这个脚本比普通更新更彻底,它会:
36+
- ✅ 更新 ComfyUI 代码本身
37+
- ✅ 更新 PyTorch(针对 NVIDIA GPU CUDA 12.9)
38+
- ✅ 重新安装所有 Python 依赖包
39+
40+
**风险提示:**
41+
- 可能与现有配置产生依赖冲突
42+
- 可能破坏依赖特定包版本的自定义节点
43+
- 可能覆盖手动配置的包版本
44+
45+
**⚠️ 仅在以下情况使用此脚本:**
46+
- 需要修复依赖问题时
47+
- 进行大版本更新时
48+
- 日常更新建议使用 `update_comfyui.bat`
49+
50+
**运行此脚本前必须:**
51+
1. **备份整个 ComfyUI 安装目录**
52+
2. 记录已安装的自定义包版本
53+
3. 做好重新安装自定义节点的准备
54+
</Warning>
3155
</Tab>
3256
<Tab title="桌面版">
3357
ComfyUI 桌面版采用自动更新机制,确保你始终使用最新版本,不过由于 Desktop 版本是基于稳定版本构建的,所以它的功能更新相对滞后,你也可以访问 [下载页面](https://www.comfy.org/download) 来获取最新版本。

0 commit comments

Comments
 (0)