Skip to main content

ComfyUV Deployment Guide

Overview

This guide explains how to deploy the Docker image:

sandichhuu/comfyuv on Docker Hub

The image provides a pre-configured environment for running ComfyUI with:

  • Python managed by UV
  • Optimized PyTorch environment
  • SageAttention support
  • CUDA acceleration
  • Containerized deployment workflow

Requirements

Required

  • NVIDIA GPU
  • NVIDIA Container Toolkit
  • Docker Engine
  • CUDA-compatible drivers
  • 16GB+ VRAM
  • SSD storage
  • Linux host

Quick Start

Pull the Image

docker pull sandichhuu/comfyuv:latest

Docker Compose Example

services:
  comfyuv:
    image: sandichhuu/comfyuv:cu132cpp313
    container_name: comfyuv
    ipc: host
    port:
      8188:8188
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]
    volumes:
      - ./config.ini:/comfy/user/__manager/config.ini
      - ./input:/comfy/input
      - ./output:/comfy/output
      - ./workflows:/comfy/user/default/workflows
      - ./models:/comfy/models
      - comfy:/comfy
      - comfyuv_python_packages:/usr/local/lib/python3.13/site-packages
    environment:
      - DO_NOT_TRACK=1
      - COMFY_NO_TELEMETRY=1
    command: >
      --listen 0.0.0.0
      --enable-triton-backend
      --enable-manager
      --use-sage-attention
      --disable-pinned-memory
      --fast fp8_matrix_mult autotune
      --front-end-version Comfy-Org/ComfyUI_frontend@latest

volumes:
  comfyuv:
  comfyuv_python_packages:

Start:

docker compose up -d

Access ComfyUI

Open:

http://localhost:8188

project/
├── models/
├── input/
├── output/
├── workflows/
├── config.ini
└── docker-compose.yml

For long-term deployments:

  • Reverse proxy with Caddy or Traefik
  • Modify config.ini
[default]
git_exe = 
use_uv = True
use_unified_resolver = False
channel_url = https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main
share_option = all
bypass_ssl = False
file_logging = True
update_policy = stable-comfyui
windows_selector_event_loop_policy = False
model_download_by_agent = False
downgrade_blacklist = 
security_level = normal
always_lazy_install = False
network_mode = personal_cloud
db_mode = cache
verbose = False

Notes

  • First startup may take time due to model indexing.
  • Large models should be mounted from persistent storage.
  • SageAttention support depends on GPU architecture and CUDA compatibility.
  • Some custom nodes may still require additional dependencies.

(docs.docker.com)

Back to top