Skip to main content

​
Common issues

​
Custom git executable path

If your git.exe is installed in a specific location other than the system default:
  1. Install ComfyUI-Manager and run ComfyUI once
  2. Open <USER_DIRECTORY>/default/ComfyUI-Manager/config.ini
  3. Specify the full path including the file name in git_exe =
git_exe = C:\Program Files\Git\bin\git.exe

​
ComfyUI-Manager update fails

If updating ComfyUI-Manager itself fails, go to the ComfyUI-Manager directory and run: 
git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull

​
Windows: Overlapped Object error

If you encounter Overlapped Object has pending operation at deallocation on ComfyUI Manager load: Edit config.ini and add: 
windows_selector_event_loop_policy = True

​
SSL certificate verification failed

If you encounter SSL: CERTIFICATE_VERIFY_FAILED error: Edit config.ini and add: 
bypass_ssl = True

​
Installation issues

​
Incorrect installation path

ComfyUI-Manager files must be located in ComfyUI/custom_nodes/comfyui-manager. Common mistakes to avoid:
IssueProblem
Files in wrong locationManager files like __init__.py placed directly in custom_nodes directory
Double nested folderInstalled as custom_nodes/ComfyUI-Manager/ComfyUI-Manager
Wrong folder nameInstalled as custom_nodes/ComfyUI-Manager-main
Compressed formatInstalling from a compressed file without proper extraction
If installed incorrectly, ComfyUI-Manager may appear to work but won’t be recognized for updates and may cause duplicate installations. Remove it and reinstall properly via git clone.

​
Network issues

​
GitHub access problems

If you have limited access to GitHub, set the GITHUB_ENDPOINT environment variable: 
GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com

​
Hugging Face access problems

If you have limited access to Hugging Face, set the HF_ENDPOINT environment variable: 
HF_ENDPOINT=https://some-hf-mirror.com

​
Scanner troubleshooting

When running the scan.sh script:
  • It updates extension-node-map.json by pulling or cloning custom nodes listed in custom-node-list.json into ~/.tmp/default
  • It updates github-stats.json using the GitHub API
OptionDescription
--skip-updateSkip updating extension-node-map.json
--skip-stat-updateSkip updating github-stats.json
--skip-allSkip both update steps
To avoid GitHub API rate limits, set your token: export GITHUB_TOKEN=your_token_here
If you want to specify a different path instead of ~/.tmp/default, run python scanner.py [path] directly instead of scan.sh.

​
Security policy

If you encounter the error This action is not allowed with this security level configuration when installing custom nodes via git URL or using the nightly version, you need to adjust the security level in your config.ini file. The config.ini file is located at:
  • ComfyUI v0.3.76+: <USER_DIRECTORY>/__manager/config.ini
  • Older versions: <USER_DIRECTORY>/default/ComfyUI-Manager/config.ini
Where <USER_DIRECTORY> defaults to ComfyUI/user. See Configuration for more details. Configure security levels in config.ini: 
security_level = normal
LevelDescription
strongDoesn’t allow high and middle level risky features
normalDoesn’t allow high level risky features; middle level features available
normal-Doesn’t allow high level risky features if --listen is specified and not starts with 127.; middle level features available
weakAll features available

​
Risk levels for features

Risk LevelFeatures
HighInstall via git url, pip install, installation of custom nodes not in default channel, fix custom nodes
MiddleUninstall/Update, installation of custom nodes in default channel, restore/remove snapshot, restart
LowUpdate ComfyUI
To install custom nodes via git URL or nightly versions, set security_level = weak in your config.ini.

​
Getting help

If you’re still experiencing issues:
  1. Check the ComfyUI-Manager GitHub issues for similar problems
  2. Review the startup log messages for error details
  3. Join the ComfyUI Discord for community support