Skip to main content

ComfyUV Deployment Guide

Overview

This guide explains how to deploy the Docker image:

sandichhuu/comfyuv on Docker Hub

An optimized, production-ready ComfyUI Docker image built with uv for ultra-fast Python package management. It comes pre-configured with modern performance optimizations like Triton, SageAttention.

Important Note:

⚠️ This image is only support nvidia RTX20xx (sm75), RTX30xx (sm86). Compatible with higher GPU RTX40xx, 50xx, ..., but not optimized.

⚠️ Unsupport xformers (cu132 have no pre-build for this package).

Compatible GPU List

    SM75 : RTX 2060, 2070, 2080, 2080 Ti, and their Super/Laptop variants.

    SM86 : RTX 3050, 3060, 3070, 3080, 3090, A2, A10, A16, A40, A2000, A4000, A5000, A6000 and their Super/Laptop variants.

    Why use this Docker image for ComfyUI?

    • Blazing Fast Execution: Leverages uv for ultra-fast package management and bytecode compilation. Built on CUDA 13.2, delivering superior performance compared to older versions like CUDA 12.8 or 13.0.
    • Precompiled Ecosystem: Comes out-of-the-box with precompiled essential packages and popular custom nodes, saving you significant setup and compile time.
    • Privacy-Focused (No Analytics): Completely stripped of telemetry and analytics tracking. Your data and workflows remain entirely private.
    • Optimized for cloud: You can public the website without configuration. Use caddy or nginx for authentication.

    Preinstalled sage-attn and custom nodes:

    Quick Start (Docker Compose)

    The easiest way to run comfyuv is using Docker Compose with NVIDIA Container Toolkit installed.

    ⚠️ Make sure nvidia driver, cuda tookit are installed before start (just run nvidia-smi on terminal to test).

    Create a docker-compose.yml file:

    services:
  comfyuv:
    image: sandichhuu/comfyuv:sm86cu132
    container_name: comfyuv
    ipc: host
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]
    volumes:
      - ./input:/comfy/input
      - ./output:/comfy/output
      - ./workflows:/comfy/user/default/workflows
      - ./models:/comfy/models
      - ./workflows:/comfy/user/default/workflows
      
      - comfyuv:/comfy
      - uv_cache:/root/.cache/uv
    command: >
      --enable-triton-backend
#     --use-flash-attention unsupport becase it take long times to compile.
      --use-sage-attention
      --disable-pinned-memory
      --fast fp8_matrix_mult autotune
      --front-end-version Comfy-Org/ComfyUI_frontend@latest

volumes:
  comfyuv:
  uv_cache:

    Structure

    comfyuv/
├── docker-compose.yml
├── config.ini
├── input/
├── models/
├── workflows/
└── output/
    Back to top