I’ve been encountering a persistent SSL error when trying to connect to the ComfyUI API. Despite multiple fixes and configuration attempts, the issue still occurs consistently.
Error Message
ComfyUI API Error: A0C3C08CFFFF0000:error:0A0003FC:SSL routines:ssl3_read_bytes:sslv3 alert bad record mac:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1605:SSL alert number 20
Environment Details
-
Deployment type: Docker container (ComfyUI + external client)
-
Base image: (e.g.,
comfyui/comfyui:latestor your custom image) -
Python version: (Python 3)
-
OS / Host platform: (Docker Desktop on macOS)
-
Network setup: API client connects to ComfyUI running inside a container via exposed port (e.g.,
0.0.0.0:8188)
What I’ve Tried
-
Regenerated SSL certificates for both client and ComfyUI
-
Disabled and re-enabled SSL verification
-
Tried both HTTP and HTTPS endpoints
-
Tested different OpenSSL versions
-
Rebuilt Docker containers with clean volumes
-
Used
--listen 0.0.0.0 --port 8188when starting ComfyUI
Expected Behavior
The ComfyUI API should accept requests without SSL negotiation errors.
Actual Behavior
The API throws the sslv3 alert bad record mac error whenever a request is made — even though the API endpoint is reachable and accessible.
Additional Context
If this is related to specific TLS versions or SSL cipher mismatches between the containerized ComfyUI server and the API client, any insight into recommended configuration or flags would be appreciated.