> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI-Manager Installation

> 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 theme={null}
   .\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt
   ```

2. Launch ComfyUI with the manager enabled:
   ```bash theme={null}
   .\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 theme={null}
   # Windows
   venv\Scripts\activate

   # Linux/macOS
   source venv/bin/activate
   ```

2. Install the manager dependencies:
   ```bash theme={null}
   pip install -r manager_requirements.txt
   ```

3. Enable the manager with the `--enable-manager` flag when running ComfyUI:
   ```bash theme={null}
   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 theme={null}
    python main.py --enable-manager
    ```

    To use the legacy UI:

    ```bash theme={null}
    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**

    <img src="https://mintcdn.com/dripart/CxMos8ZkVvuvON40/images/manager/manager_use_legacy_manager_ui.png?fit=max&auto=format&n=CxMos8ZkVvuvON40&q=85&s=5a47648f9d602868c022a17b01c4d2df" alt="Switch to legacy UI" width="4266" height="3150" data-path="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 theme={null}
     git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
     ```
  3. Install the manager dependencies:
     ```bash theme={null}
     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 theme={null}
  python -m venv venv
  venv\Scripts\activate
  pip install comfy-cli
  comfy install
  ```

  **Linux/macOS:**

  ```bash theme={null}
  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 theme={null}
     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>