Comfy-Org · comfyui-wiki · Dec 29, 2025 · Dec 3, 2025 · Dec 3, 2025 · Dec 3, 2025
diff --git a/docs.json b/docs.json
@@ -45,9 +45,7 @@
                   {
                     "group": "Cloud Features",
                     "icon": "cloud",
-                    "pages": [
-                      "cloud/import-models"
-                    ]
+                    "pages": ["cloud/import-models"]
                   },
                   "installation/install_custom_node",
                   "get_started/first_generation"
@@ -93,6 +91,23 @@
                       "interface/settings/about",
                       "interface/settings/server-config"
                     ]
+                  },
+                  {
+                    "group": "ComfyUI-Manager",
+                    "icon": "puzzle-piece",
+                    "pages": [
+                      "manager/overview",
+                      "manager/install",
+                      {
+                        "group": "Node Management",
+                        "pages": [
+                          "manager/pack-management",
+                          "manager/legacy-ui"
+                        ]
+                      },
+                      "manager/configuration",
+                      "manager/troubleshooting"
+                    ]
                   }
                 ]
               },
@@ -745,6 +760,23 @@
                       "zh-CN/interface/settings/about",
                       "zh-CN/interface/settings/server-config"
                     ]
+                  },
+                  {
+                    "group": "ComfyUI-Manager",
+                    "icon": "puzzle-piece",
+                    "pages": [
+                      "zh-CN/manager/overview",
+                      "zh-CN/manager/install",
+                      {
+                        "group": "自定义节点管理",
+                        "pages": [
+                          "zh-CN/manager/pack-management",
+                          "zh-CN/manager/legacy-ui"
+                        ]
+                      },
+                      "zh-CN/manager/configuration",
+                      "zh-CN/manager/troubleshooting"
+                    ]
                   }
                 ]
               },

diff --git a/images/manager/manager_button.jpg b/images/manager/manager_button.jpg
diff --git a/images/manager/manager_entry.jpg b/images/manager/manager_entry.jpg
diff --git a/images/manager/manager_install_node.jpg b/images/manager/manager_install_node.jpg
diff --git a/images/manager/manager_list.jpg b/images/manager/manager_list.jpg
diff --git a/images/manager/manager_use_legacy_manager_ui.png b/images/manager/manager_use_legacy_manager_ui.png
diff --git a/images/manager/manger_missing_nodes-1.jpg b/images/manager/manger_missing_nodes-1.jpg
diff --git a/images/manager/manger_missing_nodes-2.jpg b/images/manager/manger_missing_nodes-2.jpg
diff --git a/images/manager/manger_missing_nodes-3.jpg b/images/manager/manger_missing_nodes-3.jpg
diff --git a/images/manager/manger_node_version.jpg b/images/manager/manger_node_version.jpg
diff --git a/images/manager/manger_remove_nodes.jpg b/images/manager/manger_remove_nodes.jpg
diff --git a/images/manager/new_ui_filter.jpg b/images/manager/new_ui_filter.jpg
diff --git a/images/manager/new_ui_install_pack.jpg b/images/manager/new_ui_install_pack.jpg
diff --git a/images/manager/new_ui_labeled.jpg b/images/manager/new_ui_labeled.jpg
diff --git a/images/manager/new_ui_missing_pack.jpg b/images/manager/new_ui_missing_pack.jpg
diff --git a/images/manager/new_ui_missing_packs_prompt.jpg b/images/manager/new_ui_missing_packs_prompt.jpg
diff --git a/images/manager/new_ui_uninstall_pack.jpg b/images/manager/new_ui_uninstall_pack.jpg
diff --git a/images/manager/new_ui_update_pack.jpg b/images/manager/new_ui_update_pack.jpg
diff --git a/manager/configuration.mdx b/manager/configuration.mdx
@@ -0,0 +1,138 @@
+---
+title: Configuration
+sidebarTitle: Config
+description: Configure ComfyUI-Manager settings
+---
+
+## Configuration paths
+
+Starting from V3.38, Manager uses a protected system path for enhanced security.
+
+| ComfyUI Version | Manager Path |
+|-----------------|--------------|
+| v0.3.76+ (with System User API) | `<USER_DIRECTORY>/__manager/` |
+| Older versions | `<USER_DIRECTORY>/default/ComfyUI-Manager/` |
+
+<Note>
+If executed without any options, the `<USER_DIRECTORY>` path defaults to `ComfyUI/user`. It can be set using `--user-directory <USER_DIRECTORY>`.
+</Note>
+
+### Configuration files
+
+| File | Description |
+|------|-------------|
+| `config.ini` | Basic configuration |
+| `channels.list` | Configurable channel lists |
+| `pip_overrides.json` | Custom pip package mappings |
+| `pip_blacklist.list` | Packages to prevent installation |
+| `pip_auto_fix.list` | Packages to auto-restore |
+| `snapshots/` | Saved snapshot files |
+| `startup-scripts/` | Startup script files |
+| `components/` | Component files |
+
+## Config.ini options
+
+Modify the `config.ini` file to apply settings. The path is displayed in startup log messages.
+
+```ini
+[default]
+git_exe = <path to git executable>
+use_uv = <True/False - use uv instead of pip>
+default_cache_as_channel_url = <True/False - retrieve DB designated as channel_url at startup>
+bypass_ssl = <True/False - disable SSL if errors occur>
+file_logging = <True/False - create log file>
+windows_selector_event_loop_policy = <True/False - fix event loop errors on Windows>
+model_download_by_agent = <True/False - use agent for model downloads>
+downgrade_blacklist = <comma-separated list of packages to prevent downgrades>
+security_level = <strong|normal|normal-|weak>
+always_lazy_install = <True/False - perform dependency installation on restart>
+network_mode = <public|private|offline>
+```
+
+### Network modes
+
+| Mode | Description |
+|------|-------------|
+| `public` | Standard public network environment |
+| `private` | Closed network with private node DB configured via `channel_url` (uses cache if available) |
+| `offline` | No external connections (uses cache if available) |
+
+### Security levels
+
+| Level | Description |
+|-------|-------------|
+| `strong` | Doesn't allow high and middle level risky features |
+| `normal` | Doesn'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 |
+| `weak` | All features available |
+
+#### Risk levels for features
+
+| Risk Level | Features |
+|------------|----------|
+| **High** | Install via git url, pip install, installation of custom nodes not in default channel, fix custom nodes |
+| **Middle** | Uninstall/Update, installation of custom nodes in default channel, restore/remove snapshot, restart |
+| **Low** | Update ComfyUI |
+
+## Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `COMFYUI_PATH` | Installation path of ComfyUI |
+| `GITHUB_ENDPOINT` | Reverse proxy for GitHub access |
+| `HF_ENDPOINT` | Reverse proxy for Hugging Face access |
+
+### Examples
+
+Redirecting GitHub requests through a proxy:
+```bash
+GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com
+```
+
+Changing Hugging Face endpoint:
+```bash
+HF_ENDPOINT=https://some-hf-mirror.com
+```
+
+## Advanced configuration
+
+### Prevent downgrade of specific packages
+
+List package names in the `downgrade_blacklist` section of `config.ini`, separated by commas:
+
+```ini
+downgrade_blacklist = diffusers, kornia
+```
+
+### Custom pip mapping
+
+Create a `pip_overrides.json` file to change the installation of specific pip packages to user-defined installations. Refer to `pip_overrides.json.template` for the format.
+
+### Prevent installation of specific pip packages
+
+List package names one per line in the `pip_blacklist.list` file.
+
+### Automatically restore pip installation
+
+List pip spec requirements in `pip_auto_fix.list` (similar to `requirements.txt`). It will automatically restore specified versions when starting ComfyUI or when versions get mismatched during custom node installations. `--index-url` can be used.
+
+### Use aria2 as downloader
+
+For faster downloads, you can configure ComfyUI-Manager to use aria2. See the [aria2 setup guide](https://github.com/ltdrdata/ComfyUI-Manager/blob/main/docs/en/use_aria2.md).
+
+## extra_model_paths.yaml configuration
+
+The following settings are applied based on the section marked as `is_default`:
+
+- `custom_nodes`: Path for installing custom nodes
+- `download_model_base`: Path for downloading models
+
+## CLI tools
+
+ComfyUI-Manager provides `cm-cli`, a command line tool that allows you to use Manager features without running ComfyUI. This is useful for automating custom node installation and managing installations in headless environments.
+
+For detailed cm-cli documentation, see the [official cm-cli guide](https://github.com/ltdrdata/ComfyUI-Manager/blob/main/docs/en/cm-cli.md).
+
+For a more comprehensive CLI experience, consider using [comfy-cli](/comfy-cli/getting-started).
+
+
diff --git a/manager/install.mdx b/manager/install.mdx
@@ -0,0 +1,145 @@
+---
+title: ComfyUI-Manager Installation
+sidebarTitle: Install
+description: How to install ComfyUI-Manager for different setups
+---
+
+## Desktop users
+
+If you're using [ComfyUI Desktop](/installation/desktop/windows), ComfyUI-Manager is already included and enabled by default. No additional installation is required.
+
+## Portable users
+
+For users running the [Windows Portable](/installation/comfyui_portable_windows) version, the new ComfyUI-Manager is built into ComfyUI core but needs to be enabled.
+
+1. Install the manager dependencies:
+   ```bash
+   .\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt
+   ```
+
+2. Launch ComfyUI with the manager enabled:
+   ```bash
+   .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager
+   pause
+   ```
+
+## Manual install users
+
+For users with a [manual installation](/installation/manual_install), the new ComfyUI-Manager is built into ComfyUI core but needs to be enabled.
+
+1. Activate your virtual environment:
+   ```bash
+   # Windows
+   venv\Scripts\activate
+
+   # Linux/macOS
+   source venv/bin/activate
+   ```
+
+2. Install the manager dependencies:
+   ```bash
+   pip install -r manager_requirements.txt
+   ```
+
+3. Enable the manager with the `--enable-manager` flag when running ComfyUI:
+   ```bash
+   python main.py --enable-manager
+   ```
+
+### Command line options
+
+| Flag | Description |
+|------|-------------|
+| `--enable-manager` | Enable ComfyUI-Manager |
+| `--enable-manager-legacy-ui` | Use the legacy manager UI instead of the new UI (requires `--enable-manager`) |
+| `--disable-manager-ui` | Disable the manager UI and endpoints while keeping background features (requires `--enable-manager`) |
+
+### Switch between new and legacy UI
+
+The following version updates only support pip installations. Versions installed via custom nodes do not support switching to the new UI.
+
+<Tabs>
+<Tab title="Non-Desktop users">
+To use the new UI:
+```bash
+python main.py --enable-manager
+```
+
+To use the legacy UI:
+```bash
+python main.py --enable-manager --enable-manager-legacy-ui
+```
+
+</Tab>
+<Tab title="Desktop users">
+Desktop users can switch to the legacy UI in **Server Settings → UI Settings → Use legacy manager interface**
+![Switch to legacy UI](/images/manager/manager_use_legacy_manager_ui.png)
+</Tab>
+</Tabs>
+
+## Legacy installation methods
+
+<Accordion title="Method 1: Git clone (general installation)">
+To install ComfyUI-Manager in addition to an existing installation of ComfyUI:
+
+1. Navigate to `ComfyUI/custom_nodes` directory in terminal
+2. Clone the repository:
+   ```bash
+   git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
+   ```
+3. Install the manager dependencies:
+   ```bash
+   cd comfyui-manager
+   pip install -r requirements.txt
+   ```
+4. Restart ComfyUI
+</Accordion>
+
+<Accordion title="Method 2: Portable version (Windows)">
+1. Install [Git for Windows](https://git-scm.com/download/win) (standalone version, select "use windows default console window")
+2. Download [install-manager-for-portable-version.bat](https://github.com/ltdrdata/ComfyUI-Manager/raw/main/scripts/install-manager-for-portable-version.bat) into your `ComfyUI_windows_portable` directory
+3. Double-click the batch file to install
+</Accordion>
+
+<Accordion title="Method 3: comfy-cli (recommended for new installations)">
+comfy-cli provides various features to manage ComfyUI from the CLI.
+
+**Prerequisites**: Python 3, Git
+
+**Windows:**
+```bash
+python -m venv venv
+venv\Scripts\activate
+pip install comfy-cli
+comfy install
+```
+
+**Linux/macOS:**
+```bash
+python -m venv venv
+. venv/bin/activate
+pip install comfy-cli
+comfy install
+```
+
+See also: [comfy-cli documentation](/comfy-cli/getting-started)
+</Accordion>
+
+<Accordion title="Method 4: Linux + venv">
+**Prerequisites**: python-is-python3, python3-venv, git
+
+1. Download [install-comfyui-venv-linux.sh](https://github.com/comfy-org/ComfyUI-Manager/raw/main/scripts/install-comfyui-venv-linux.sh) into an empty install directory
+2. Run:
+   ```bash
+   chmod +x install-comfyui-venv-linux.sh
+   ./install-comfyui-venv-linux.sh
+   ```
+3. Execute ComfyUI with `./run_gpu.sh` or `./run_cpu.sh`
+</Accordion>
+
+<Warning>
+**Installation precautions:**
+- ComfyUI-Manager files must be accurately located in the path `ComfyUI/custom_nodes/comfyui-manager`
+- Do not decompress directly into `ComfyUI/custom_nodes` (files like `__init__.py` should not be in that directory)
+- Do not install in paths like `ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager` or `ComfyUI/custom_nodes/ComfyUI-Manager-main`
+</Warning>