Skip to main content

​
Common issues

​
Custom git executable path

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

​
ComfyUI-Manager update fails

If updating ComfyUI-Manager itself fails:
  1. Navigate to the ComfyUI-Manager directory
  2. 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

​
File logging

File logging is enabled by default. To disable: Edit config.ini: 
file_logging = False

​
Custom node support guide

You should no longer assume that the GitHub repository name will match the subdirectory name under custom_nodes. The subdirectory name now uses the normalized name from the name field in pyproject.toml.
Avoid relying on directory names for imports whenever possible.

​
Resources for developers

​
Special purpose files (optional)

FileDescription
pyproject.tomlSpec file for comfyregistry
node_list.jsonManual list of nodes when NODE_CLASS_MAPPINGS pattern is non-conventional
requirements.txtPip requirements installed automatically
install.pyScript called automatically during installation
All scripts are executed from the root path of the corresponding custom node.

​
Registering custom nodes

To register your custom node in ComfyUI-Manager:
  1. Add an entry to custom-node-list.json in the root of ComfyUI-Manager
  2. Submit a Pull Request
  3. Before submitting, check Use local DB and ensure the extension list loads without issues in the Install custom nodes dialog
Check for missing or extra commas that can lead to JSON syntax errors.

​
Disclaimer

This extension provides the convenience of installing custom nodes and does not guarantee their proper functioning.