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 RTX30xx (sm86).

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

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