frequent-errors
"Deployment Failed: Installing ComfyUI-Manager"
How to fix deployment failures at the ComfyUI-Manager installation step
Symptoms
During the first ComfyUI environment deployment, the progress stalls at the "Installing ComfyUI-Manager" step and then reports a deployment failure.
Cause
ComfyUI-Manager is the plugin manager for ComfyUI (repository: https://github.com/Comfy-Org/ComfyUI-Manager). Wonderful Launcher uses git clone to download it into the custom_nodes/ directory during deployment. The clone can fail for several reasons:
- Cannot reach GitHub: Direct connections to GitHub may be unstable or blocked in certain regions
- Proxy not passed to Git: A system proxy (Clash, V2Ray, etc.) is running, but Git is not configured to use it
- SSL certificate error: Corporate networks, antivirus software, or firewalls intercept HTTPS traffic, causing Git to report
SSL certificate problem - Path too long: Windows has a default path length limit of 260 characters; deeply nested directories can trigger a
Filename too longerror - Git not installed or outdated: Git is missing from the system or the version is below 2.20
Severity
High -- blocks the first deployment. ComfyUI itself can still run, but without plugin management features.
Solutions
Option 1: Configure a proxy for Git (recommended for users in China)
If you use a proxy tool such as Clash or V2Ray, you need to configure Git to route through the same proxy. Open Command Prompt or PowerShell and run:
HTTP proxy (Clash default port 7890):
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
SOCKS5 proxy (some tools use a SOCKS5 port):
git config --global http.proxy socks5://127.0.0.1:7891
git config --global https.proxy socks5://127.0.0.1:7891
Apply only to GitHub (to avoid affecting other repositories):
git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890
After configuring, retry the deployment in Wonderful Launcher.
To remove the proxy configuration:
git config --global --unset http.proxy
git config --global --unset https.proxy
Option 2: Fix SSL certificate errors
If the error message contains SSL certificate problem, a corporate network, antivirus software, or firewall may be intercepting the HTTPS connection.
Recommended -- use the Windows certificate store:
git config --global http.sslBackend schannel
This makes Git trust the same certificates as your browser, which usually resolves SSL issues in corporate network environments.
Temporary workaround -- disable SSL verification (use only on trusted networks):
git config --global http.sslVerify false
Be sure to re-enable it once the issue is resolved:
git config --global http.sslVerify true
Update Git:
Older versions of Git may ship with an expired CA certificate bundle. Download the latest version from https://git-scm.com/.
Option 3: Fix path-too-long errors
If the error message contains Filename too long, you need to enable long path support on Windows.
Enable Git long paths:
Open Command Prompt as Administrator and run:
git config --system core.longpaths true
Enable Windows long paths (optional, requires restart):
Open PowerShell as Administrator and run:
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
You will need to sign out or restart your computer after making this change.
Additionally, consider installing ComfyUI to a shorter path (e.g., D:\ComfyUI) to avoid deeply nested directories.
Option 4: Install ComfyUI-Manager manually
If none of the above methods work, you can skip the automatic installation and do it manually.
Find your ComfyUI installation path in Wonderful Launcher (shown on the Environments page). The examples below assume
D:\ComfyUI.Open Command Prompt or PowerShell and run:
cd D:\ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
If a direct connection fails, specify the proxy inline:
git clone -c http.proxy=http://127.0.0.1:7890 https://github.com/Comfy-Org/ComfyUI-Manager.git
- Verify the installation:
dir D:\ComfyUI\custom_nodes\ComfyUI-Manager
You should see files such as __init__.py and a js directory. If the directory exists and is not empty, the installation was successful.
- Restart ComfyUI in Wonderful Launcher. The Manager will load automatically.
Option 5: Verify that Git is available
Confirm that Git is installed and accessible from the command line:
git --version
If the command is not found, download and install Git for Windows from https://git-scm.com/. During installation, make sure the "Add to PATH" option is checked.
Still not resolved?
If the issue persists after trying all of the above, contact support through the "Contact Us" button in the app and include the following information:
- A full screenshot of the error message
- The output of
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git - The output of
git config --global --list
Wonderful Launcher Dokümanları