ComfyUI-Docker

An automated Repo for ComfyUI Docker image builds, optimized for NVIDIA GPUs.

About • Features • Getting Started • Usage • License

---

About

This repository automates the creation of Docker images for ComfyUI, a powerful and modular stable diffusion GUI and backend. It syncs with the upstream ComfyUI repository, builds a Docker image on new releases, and pushes it to GitHub Container Registry (GHCR).

I created this repo for myself as a simple way to stay up to date with the latest ComfyUI versions while having an easy-to-use Docker image. It's particularly suited for setups with NVIDIA GPUs, leveraging CUDA for accelerated performance.

Why Docker? It provides a consistent, isolated environment that's easy to deploy, update, and scale, perfect for AI workflows without messing with your host system.

Built With

• Docker
• GitHub Actions for automation
• PyTorch with CUDA support
• Based on Python 3.13 slim image

---

Features

• Automated Sync & Build: Daily checks for upstream releases, auto-merges changes, and builds/pushes Docker images.
• NVIDIA GPU Ready: Pre-configured with CUDA-enabled PyTorch for seamless GPU acceleration.
• Non-Root Runtime: Runs as a non-root user for better security.
• Pre-Installed Manager: Includes ComfyUI-Manager for easy node/extensions management.
• Lightweight: Uses a slim Python base image to keep the size down.
• Customizable: Pass environment varibles with COMFYUI_ in docker-compose.

---

Getting Started

Prerequisites

• Docker: Installed on your host (e.g., Docker Desktop or Engine).
• NVIDIA GPU: For GPU support (ensure NVIDIA drivers and CUDA are installed on the host).
• NVIDIA Container Toolkit: For GPU passthrough in Docker (install via official guide).

Pulling the Image

The latest image is available on GHCR:

docker pull ghcr.io/clsferguson/comfyui-docker:latest

For a specific version (synced with upstream tags, starting at 0.3.57):

docker pull ghcr.io/clsferguson/comfyui-docker:vX.Y.Z

Docker Compose

For easier management, use this docker-compose.yml:

services:
  comfyui:
    image: ghcr.io/clsferguson/comfyui-docker:latest
    container_name: ComfyUI
    runtime: nvidia
    restart: unless-stopped
    ports:
      - 8188:8188
    environment:
      - TZ=America/Edmonton
      - PUID=1000
      - GUID=1000
      #- COMFYUI_SOME_ENV_VAR=SOME_VALUE
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]
    volumes:
      - comfyui_data:/app/ComfyUI/user/default
      - comfyui_nodes:/app/ComfyUI/custom_nodes
      - /mnt/comfyui/models:/app/ComfyUI/models
      - /mnt/comfyui/input:/app/ComfyUI/input
      - /mnt/comfyui/output:/app/ComfyUI/output

Run with docker compose up -d.

---

Usage

Basic Usage

Access ComfyUI at http://localhost:8188 after starting the container using Docker Compose.

Environment Variables

• Set via .env file or -e flags in docker compose or docker run.
• Examples: COMFYUI_EXTRA_ARGS="--highvram" to pass extra args.

---

License

Distributed under the MIT License (same as upstream ComfyUI). See LICENSE for more information.

---

Contact

• Creator: clsferguson - GitHub
• Project Link: https://github.com/clsferguson/ComfyUI-Docker

Built with ❤️ for easy AI workflows.