From bc2dffa0b0c1221df3fc893fbb5535fb8e40b098 Mon Sep 17 00:00:00 2001
From: clsferguson <48876201+clsferguson@users.noreply.github.com>
Date: Mon, 22 Sep 2025 09:05:19 -0600
Subject: [PATCH] fix(docker): override PEP 668 externally-managed-environment
 restriction

Add PIP_BREAK_SYSTEM_PACKAGES=1 environment variable to allow system-wide
pip installations in Ubuntu 24.04 container environment.

Ubuntu 24.04 includes Python 3.12 with PEP 668 enforcement which blocks
pip installations outside virtual environments. Since this is a containerized
environment where system package conflicts are not a concern, we safely
override this restriction.

Resolves error: "externally-managed-environment" preventing PyTorch and
dependency installation during Docker build process.
---
 Dockerfile | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Dockerfile b/Dockerfile
index 05bc70e40..1db6c57c5 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -7,6 +7,7 @@ ENV DEBIAN_FRONTEND=noninteractive \
     COMFY_AUTO_INSTALL=1 \
     PIP_DISABLE_PIP_VERSION_CHECK=1 \
     PIP_NO_CACHE_DIR=1 \
+    PIP_BREAK_SYSTEM_PACKAGES=1 \
     EXT_PARALLEL=4 \
     NVCC_APPEND_FLAGS="--threads 8" \
     MAX_JOBS=32 \