ComfyUI-Nvidia-Docker

ComfyUI-Nvidia-Docker

Docker app from martial's Repository

Overview

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 basedir/output folder within the "basedir" directory.

Please see https://github.com/mmartial/ComfyUI-Nvidia-Docker for further details.

  • Recommending setting USE_UV to true to use uv instead of pip
  • See details about "latest" tag
  • See details about "First time use" (and the "bottle" workflow), noting that Unraid's default YOUR_BASE_DIRECTORY should be /mnt/user/appdata/comfyui-nvidia/basedir
  • GTX 10xx users should use the ubuntu22_cuda12.6.3-latest tag and check the README.md for recommendations on how to run the container.
  • RTX 50xx (Blackwell) users should use at minimum ubuntu24_cuda12.8-latest tag.

Note:

  • The container requires the Nvidia Driver plugin to be installed on your Unraid server. Usually that plugin will get you access to a CUDA driver with support for the latest tag available for this container.
  • This is a WebUI for the ComfyUI Stable Diffusion tool with a Docker image of usually over 4GB.
  • The container will take a while to start up, as it needs to download the ComfyUI Stable Diffusion tool and install its dependencies, usually adding another 5GB of downloaded content in the venv folder
  • The original Docker image is from Nvidia, as such it is governed by the NVIDIA Deep Learning Container License.
  • There are multiple version of the base image available, please select the one that fits your needs best. The name of the tag is the Ubuntu version followed by the CUDA version. Latest is set to point to the most recent combination as it should include the most recent software updates. For the complete list of supported versions, please see the GitHub repository

Requirements

Nvidia Driver plugin

Runtime arguments

Web UI
http://[IP]:[PORT:8188]
Network
docker
Shell
bash
Privileged
false
Extra Params
--runtime nvidia --gpus all

Template configuration

WebUI PortPorttcp
Target
8188
Default
8188
Value
8188
run directory (venv, ComfyUI from git, ...)Pathrw
Target
/comfy/mnt
Default
/mnt/user/appdata/comfyui-nvidia/mnt
Value
/mnt/user/appdata/comfyui-nvidia/mnt
basedir directory (models, input, output, custom_nodes)Pathrw
Target
/basedir
Default
/mnt/user/appdata/comfyui-nvidia/basedir
Value
/mnt/user/appdata/comfyui-nvidia/basedir
WANTED_UIDVariable

UID to use for content in run directory

Default
99
Value
99
WANTED_GIDVariable

GID to use for content in run directory

Default
100
Value
100
USE_UVVariable

Use uv instead of pip

Default
false
Value
false
USE_NEW_MANAGERVariable

Use new ComfyUI Manager

Default
true
Value
true
ENABLE_MANAGER_LEGACY_UIVariable

Enable legacy UI for ComfyUI Manager

Default
false
Value
false
COMFY_CMDLINE_EXTRAVariable

Extra command-line options for ComfyUI

BASE_DIRECTORYVariable

Base directory for ComfyUI user directories such as models, input, output and custom_nodes

Default
/basedir
Value
/basedir
SECURITY_LEVELVariable

Modify the security level for the WebUI, see https://github.com/ltdrdata/ComfyUI-Manager?tab=readme-ov-file#security-policy for authorized values

Default
normal
Value
normal
FORCE_CHOWNVariable

Force change directory ownership as the comfy user during script startup (this process might be slow). This option was added to support users who mount the run and basedir folders onto other hosts which might not respect the UID/GID of the comfy user. Enabled by default on Unraid. To disable, set to an empty value.

Default
true
Value
true
DISABLE_UPGRADESVariable

Disable container start upgrades of python pacakges (also disables USE_PIPUPGRADE). All updates must be performed using ComfyUI Manager.

Default
false
Value
false
USE_PIPUPGRADEVariable

new default is to use pip install --upgrade, set to false to use pip install.

Default
true
Value
true
USE_SOCATVariable

Use socat to listen on port 8188 and forward to 127.0.0.1:8181 (ie use an alternate port for Comfy to run)

Default
false
Value
false
NETWORK_MODEVariable

Required to be set to personal_cloud to allow custom nodes installation

Default
personal_cloud
Value
personal_cloud

Download Statistics

200,761
Total Downloads
35,065
This Month
24,456
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
mmartial/comfyui-nvidia-docker
Last Updated2026-05-09
First Seen2024-09-02

Run ComfyUI-Nvidia-Docker on Unraid.

ComfyUI-Nvidia-Docker is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.