jimlee2048/comfyui-docker repository overview

⁠ComfyUI Docker Image

A Customizable ComfyUI⁠ docker image with automatic environment setup.

⚠️ Note: This image is designed for personal use with GUI access, not for production server deployments.

⁠Features

• Ready-to-use Python environment with common ML packages: nunchaku, sageattention2++,sageattn3, xformers, transformers, onnxruntime, opencv-python, etc.
  • See Dockerfile⁠ for complete details
• Automated management of custom nodes & models:
  • Configuration-driven setup during startup
  • Pre/Post initialization script hooks (supports .py, .sh, .bat, .ps1)
  • Multiple config files support, with optional regex-based filter for flexible updates
• Built-in aria2⁠ for accelerated large model files downloads
• Use cm-cli⁠ to install custom nodes.
• Support install custom nodes from Comfy Registry⁠
• Optional optimizations for users in the Chinese Mainland (mirrors for pip/Hugging Face/Civitai)

⁠Available Image Tags

Image Tag	Compute Platform	PyTorch Version	Python Version	ComfyUI Version	Note
latest / vX.Y.Z					Recommend
nightly

⁠Environment Variables

⁠Quick Start

1. Clone this repository, mount docker/ as working directory:

   git clone https://github.com/jimlee2048/comfyui-docker
   cd comfyui-docker/docker
   

   Copy

2. Create and configure docker/.env file base on example:

   cp example.env .env
   

   Copy

   see docker/example.env⁠ for more details.

3. (Optional) Set up automatic node/model management:

   • Set INIT_NODE=true or/and INIT_MODEL=true in docker/.env
   • Create your boot config in docker/config/ see docker/config/example.toml⁠ for more details.

4. Create and configure docker/compose.yml file base on example:

   cp compose.example.yml compose.yml
   

   Copy

   see docker/compose.example.yml⁠ for more details.

5. Launch ComfyUI:

   • Run in foreground to see logs, recommended for first run.

     docker compose up
     

     Copy
   • Or in background as services.

     docker compose up -d
     

     Copy

   First run may take longer due to node installation and model downloads.

6. Access ComfyUI at http://localhost:8188

7. To stop:

   docker compose down
   

   Copy

⁠Updates & Maintenance

⁠Configuration Changes

When modifying boot config or environment variables, do not use ComfyUI Manager's restart function on the web interface.

Instead, restart the container to apply changes:

docker compose down
docker compose up -d

⁠ComfyUI Updates

• Option 1: Use ComfyUI Manager in the web interface

• Option 2: Pull latest image:

  docker compose pull
  docker compose down
  docker compose up -d
  

  Copy

⁠TODO

• ROCm version for AMD GPU
• XPU version for Intel GPU