"Deployment Failed: Installing ComfyUI-Manager"

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 long error
• 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.

1. Find your ComfyUI installation path in Wonderful Launcher (shown on the Environments page). The examples below assume D:\ComfyUI.

2. 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

1. 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.

1. 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