{"id":24907394,"url":"https://github.com/jimlee2048/comfyui-docker","last_synced_at":"2026-04-12T17:52:06.261Z","repository":{"id":273126550,"uuid":"918772541","full_name":"jimlee2048/comfyui-docker","owner":"jimlee2048","description":"Customizable ComfyUI docker image with automatic environment setup","archived":false,"fork":false,"pushed_at":"2025-03-11T16:42:03.000Z","size":119,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-11T17:47:19.120Z","etag":null,"topics":["comfyui","docker","docker-compose","stable-diffusion"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jimlee2048.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-18T20:15:34.000Z","updated_at":"2025-03-11T16:42:07.000Z","dependencies_parsed_at":"2025-03-11T17:44:54.069Z","dependency_job_id":null,"html_url":"https://github.com/jimlee2048/comfyui-docker","commit_stats":null,"previous_names":["jimlee2048/comfyui-docker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimlee2048%2Fcomfyui-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimlee2048%2Fcomfyui-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimlee2048%2Fcomfyui-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimlee2048%2Fcomfyui-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jimlee2048","download_url":"https://codeload.github.com/jimlee2048/comfyui-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245938230,"owners_count":20697008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["comfyui","docker","docker-compose","stable-diffusion"],"created_at":"2025-02-02T01:17:07.981Z","updated_at":"2026-04-12T17:52:06.251Z","avatar_url":"https://github.com/jimlee2048.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ComfyUI Docker Image\n[![GitHub Repo](https://img.shields.io/badge/GitHub-jimlee2048%2Fcomfyui--docker-blue?logo=github)](https://github.com/jimlee2048/comfyui-docker)\n[![Docker Hub](https://img.shields.io/badge/Docker%20Hub-jimlee2048%2Fcomfyui--docker-blue?logo=docker)](https://hub.docker.com/r/jimlee2048/comfyui-docker)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/jimlee2048/comfyui-docker/build-publish.yml)](https://github.com/jimlee2048/comfyui-docker/actions/workflows/build-publish.yml)\n[![Docker Image Version (tag latest)](https://img.shields.io/docker/v/jimlee2048/comfyui-docker/latest?label=latest)](https://hub.docker.com/r/jimlee2048/comfyui-docker)\n[![Docker Pulls](https://img.shields.io/docker/pulls/jimlee2048/comfyui-docker)](https://hub.docker.com/r/jimlee2048/comfyui-docker)\n\nA Customizable [ComfyUI](https://github.com/comfyanonymous/ComfyUI) docker image with automatic environment setup.\n\n⚠️ **Note**: This image is designed for personal use with GUI access, not for production server deployments.\n\n## Features\n- Ready-to-use Python environment with common ML packages: `nunchaku`, `sageattention2++`,`sageattn3`, `xformers`, `transformers`, `onnxruntime`, `opencv-python`, etc.\n - See [Dockerfile](Dockerfile.cuda) for complete details\n- Automated management of custom nodes \u0026 models:\n - Configuration-driven setup during startup\n - Pre/Post initialization script hooks (supports `.py`, `.sh`, `.bat`, `.ps1`)\n - Multiple config files support, with optional regex-based filter for flexible updates\n- Built-in [aria2](https://github.com/aria2/aria2) for accelerated large model files downloads\n- Use [cm-cli](https://github.com/ltdrdata/ComfyUI-Manager/blob/main/docs/en/cm-cli.md) to install custom nodes.\n- Support install custom nodes from [Comfy Registry](https://registry.comfy.org/)\n- Optional optimizations for users in the Chinese Mainland (mirrors for pip/Hugging Face/Civitai)\n\n## Available Image Tags\n\n| Image Tag | Compute Platform | PyTorch Version | Python Version | ComfyUI Version | Note |\n| ------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |\n| `latest` / `vX.Y.Z` | [![CUDA](https://img.shields.io/badge/CUDA-13.0-76B900?logo=nvidia)](https://hub.docker.com/r/nvidia/cuda/) | [![PyTorch](https://img.shields.io/badge/PyTorch-2.10-EE4C2C?logo=pytorch)](https://pytorch.org/) | [![Python](https://img.shields.io/badge/Python-3.13-3776AB?logo=python)](https://www.python.org/) | [![ComfyUI Release](https://img.shields.io/github/v/release/comfyanonymous/ComfyUI?label=release\u0026logo=github)](https://github.com/comfyanonymous/ComfyUI/releases/latest) | Recommend |\n| `nightly` | [![CUDA](https://img.shields.io/badge/CUDA-13.0-76B900?logo=nvidia)](https://hub.docker.com/r/nvidia/cuda/) | [![PyTorch](https://img.shields.io/badge/PyTorch-2.10-EE4C2C?logo=pytorch)](https://pytorch.org/) | [![Python](https://img.shields.io/badge/Python-3.13-3776AB?logo=python)](https://www.python.org/) | [![ComfyUI Nightly](https://img.shields.io/github/last-commit/comfyanonymous/ComfyUI?label=nightly\u0026logo=github)](https://github.com/comfyanonymous/ComfyUI/tree/master) | |\n\n## Environment Variables\n| Variable | Description | Default |\n| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |\n| INIT_NODE | Enable automatic installs/removes of custom nodes at startup | true |\n| UPDATE_NODE | Enable automatic updates of custom nodes at startup | false |\n| INIT_MODEL | Enable automatic downloads/removes of models at startup | true |\n| BOOT_CONFIG_INCLUDE | Regex pattern for including boot config files. | |\n| BOOT_CONFIG_EXCLUDE | Regex pattern for excluding boot config files. | |\n| COMFYUI_EXTRA_ARGS | Additional ComfyUI launch arguments. | |\n| HF_API_TOKEN | [Hugging Face access token](https://huggingface.co/settings/tokens) for downloading access restricted models. | |\n| CIVITAI_API_TOKEN | [Civitai API token](https://education.civitai.com/civitais-guide-to-downloading-via-api/#how-do-i-download-via-the-api) for downloading access restricted models. | |\n| CN_NETWORK | Enable network optimization for Chinese Mainland users. Changes default HF/Civitai endpoints. | false |\n| HF_ENDPOINT | Override the Hugging Face download endpoint. | `https://huggingface.co` (or `https://hf-mirror.com` if CN_NETWORK=`true`) |\n| CIVITAI_ENDPOINT | Override the Civitai download endpoint. | `https://civitai.com` (or `https://civitai.work` if CN_NETWORK=`true`) |\n\n## Quick Start\n1. Clone this repository, mount `docker/` as working directory:\n ```bash\n git clone https://github.com/jimlee2048/comfyui-docker\n cd comfyui-docker/docker\n ```\n\n2. Create and configure `docker/.env` file base on example:\n ```bash\n cp example.env .env\n ```\n see [docker/example.env](https://github.com/jimlee2048/comfyui-docker/blob/main/docker/example.env) for more details.\n\n3. (Optional) Set up automatic node/model management:\n - Set `INIT_NODE=true` or/and `INIT_MODEL=true` in `docker/.env`\n - Create your boot config in `docker/config/`\n see [docker/config/example.toml](https://github.com/jimlee2048/comfyui-docker/blob/main/docker/config/example.toml) for more details.\n\n4. Create and configure `docker/compose.yml` file base on example:\n ```bash\n cp compose.example.yml compose.yml\n ```\n see [docker/compose.example.yml](https://github.com/jimlee2048/comfyui-docker/blob/main/docker/compose.example.yml) for more details.\n\n5. Launch ComfyUI:\n - Run in foreground to see logs, recommended for first run.\n ```bash\n docker compose up\n ```\n - Or in background as services.\n ```bash\n docker compose up -d\n ```\n First run may take longer due to node installation and model downloads. \n\n6. Access ComfyUI at `http://localhost:8188`\n\n7. To stop:\n ```bash\n docker compose down\n ```\n\n## Updates \u0026 Maintenance\n\n### Configuration Changes\nWhen modifying boot config or environment variables, do not use ComfyUI Manager's restart function on the web interface.\n\nInstead, restart the container to apply changes:\n```bash\ndocker compose down\ndocker compose up -d\n```\n\n### ComfyUI Updates\n- Option 1: Use ComfyUI Manager in the web interface\n\n- Option 2: Pull latest image:\n ```bash\n docker compose pull\n docker compose down\n docker compose up -d\n ```\n\n## TODO\n- [ ] ROCm version for AMD GPU\n- [ ] XPU version for Intel GPU\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimlee2048%2Fcomfyui-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjimlee2048%2Fcomfyui-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimlee2048%2Fcomfyui-docker/lists"}