ComfyUI-Nvidia-Docker

ComfyUI WebUI Dockerfile with Nvidia support, installing ComfyUI from GitHub.

  • AI
  • Media Applications
  • Tools & Utilities
ComfyUI WebUI Dockerfile with Nvidia support, installing ComfyUI from GitHub. Also installs ComfyUI Manager to simplify integration of additional custom nodes. The "run directory" contains HF, ComfyUI and venv. The "basedir" contains input, output and custom_nodes. The ComfyUI "Manager" is installed to simplify integration of additional custom nodes and their updates. The "Manager" is also used to update ComfyUI to more recent versions. All those folders will be created with the WANTED_UID and WANTED_GID parameters (by default using Unraid's default of 99:100) allowing the end-user to place directly into the folders their checkpoints, unet, lora and other required models. The container comes with no weights/models; you need to obtain those and install them in the proper directories under the mount you have selected for the "run directory". Output files will be placed into the

Platform availability

Available on 2 of 6 install platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)

Also on Docker Hub and GitHub

Health score

69/100 Good

Maintained
95last commit 25 days ago
Popular
53435 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

How is this calculated?

A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). Factors without data are left out and the rest are rescaled.

Availability: platform listings confirmed today, links checked 4 days ago

GitHub stars
435
Open issues
0
Last commit
2026-09-14
Latest release
20260914
License
MIT
Activity
declining

Checked yesterday - source: GitHub (mmartial/ComfyUI-Nvidia-Docker)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 10 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Copy the example Compose and env files first Copy `compose.example.yml` to `compose.yml` and `example.env` to `.env`, then edit `.env` before starting. This is where you choose the image, custom nodes, model downloads, and API tokens, so ComfyUI comes up with the pieces you need instead of starting blank or missing downloads. source
  • Keep your models and settings in saved folders Make sure the `volumes/models`, `volumes/user`, and `volumes/output` folders are mapped into the container. Those folders hold your big model files, workflows/settings, and generated images, so if they are not saved outside the container you can lose them when you update or restart the app. source
  • Open port 8188 and enable NVIDIA GPU use Keep `8188:8188` in the ports section and leave the NVIDIA GPU reservation enabled. Port 8188 is the web address you type into your browser, and the GPU reservation lets Docker use your NVIDIA card; without either the interface may be unreachable or ComfyUI will not get the graphics acceleration it expects. source

Fetched 10 days ago - each note links to its source

Alternatives (6)

  • A1111 Stable Diffusion WEB UI - AUTOMATIC1111's Stable Diffusion web UI provides a powerful, web interface for Stable Diffusion featuring a one-click installer, advanced i…
  • Comfy - ComfyUI is an open-source, node-based workflow engine that empowers creators to design, customize, and run complex generative AI pipelines…
  • Draw Things - Draw Things provides a comprehensive but still easy-to-use, mobile and desktop solution for AI-based art generation.
  • InvokeAI - InvokeAI is an open-source, self-hosted Stable Diffusion toolkit for generating and editing images from text or existing images.
  • chaiNNer - A flowchart/node-based image processing GUI aimed at making chaining image processing tasks (especially upscaling done by neural networks)…
  • stability matrix - Multi-platform package manager for Stable Diffusion.

Checked 7 days ago - source: AlternativeTo

Common questions

How do I add custom nodes or update ComfyUI in this Docker setup?

The container includes ComfyUI Manager. Use the Manager to install or update custom nodes and to update ComfyUI itself.

Does the image include models, and where do I put model files?

No, the image does not ship with weights or models. The run directory holds HF, ComfyUI, and venv, while the basedir holds input, output, and custom_nodes. Those folders are created with WANTED_UID and WANTED_GID so you can add checkpoints, UNet, LoRA, and other model files.

How do I set it up on Unraid?

Add the ComfyUI NVIDIA Docker container from Community Apps. Configure UID/GID support so the container can access your model and data folders.

What common problems are documented for this container?

The troubleshooting guide covers container startup failures, permission errors, GPU access problems, virtual environment issues, and package installation failures.

Answers sourced from deepwiki.com, forums.unraid.net, github.com

Community

Collected 9 days ago - public community threads