uvicorn Feature Request: unix server support ssl (Fix)

The Fix

Upgrade to version 0.11.4 or later.

Based on closed Kludex/uvicorn issue #431 · PR/commit linked

Production note: Most teams hit this during upgrades or environment changes. Roll out with a canary and smoke critical endpoints (health, OpenAPI/docs) before 100%.

Open PR/Commit

@@ -365,7 +365,9 @@ async def startup(self, sockets=None):
             if os.path.exists(config.uds):
                 uds_perms = os.stat(config.uds).st_mode
-            server = await loop.create_unix_server(create_protocol, path=config.uds)
+            server = await loop.create_unix_server(
+                create_protocol, path=config.uds, ssl=config.ssl

fix.md

Option A — Upgrade to fixed release\nUpgrade to version 0.11.4 or later.\nWhen NOT to use: Do not use this fix if SSL is not required for your Unix server.\n\n

Why This Fix Works in Production

Trigger: Feature Request: unix server support ssl
Mechanism: The SSL configuration was not passed to the create_unix_server method
Why the fix works: Passes the SSL configuration to the Unix domain socket server creation, addressing the issue of missing SSL support in the `create_unix_server` method. (first fixed release: 0.11.4).

Production impact:

If left unfixed, the same config can fail only in production (env differences), causing startup failures or partial feature outages.

Why This Breaks in Prod

The SSL configuration was not passed to the create_unix_server method
Production symptom (often without a traceback): Feature Request: unix server support ssl

Proof / Evidence

GitHub issue: #431
Fix PR: https://github.com/kludex/uvicorn/pull/459
First fixed release: 0.11.4
Reproduced locally: No (not executed)
Last verified: 2026-02-09
Confidence: 0.85
Did this fix it?: Yes (upstream fix exists)
Own content ratio: 0.68

Discussion

High-signal excerpts from the issue thread (symptoms, repros, edge-cases).

Jump to Sources Open on GitHub

“config.ssl is not passed to create_unix_server. https://github.com/encode/uvicorn/blob/e0a77de6baf436d182868fa280cd5e2f0d66501c/uvicorn/main.py#L368 https://docs.python.org/3/library/asyncio-eventloop.html#asyncio.loop.create_unix_server”

Issue thread · issue description · source

Failure Signature (Search String)

Feature Request: unix server support ssl
`config.ssl` is not passed to `create_unix_server`.

Copy-friendly signature

signature.txt

Failure Signature
-----------------
Feature Request: unix server support ssl
`config.ssl` is not passed to `create_unix_server`.

Error Message

Signature-only (no traceback captured)

error.txt

Error Message
-------------
Feature Request: unix server support ssl
`config.ssl` is not passed to `create_unix_server`.

What Broke

SSL support was missing for Unix domain socket server creation.

Why It Broke

The SSL configuration was not passed to the create_unix_server method

Fix Options (Details)

Option A — Upgrade to fixed release Safe default (recommended)

Upgrade to version 0.11.4 or later.

When NOT to use: Do not use this fix if SSL is not required for your Unix server.

Use when you can deploy the upstream fix. It is usually lower-risk than long-lived workarounds.

Fix reference: https://github.com/kludex/uvicorn/pull/459

First fixed release: 0.11.4

Last verified: 2026-02-09. Validate in your environment.

When NOT to Use This Fix

Do not use this fix if SSL is not required for your Unix server.

Did This Fix Work in Your Case?

Quick signal helps us prioritize which fixes to verify and improve.

Prevention

Add a TLS smoke test that performs a real handshake in CI (include CA bundle validation and hostname checks).
Alert on handshake failures by error string and endpoint to catch cert/CA changes quickly.

Version Compatibility Table

Version	Status
0.11.4	Fixed

Related Issues

No related fixes found.

Cluster: uvicorn:configuration-error All hubs All clusters

Related clusters: Data consistency Race condition SSL handshake

Sources

We don’t republish the full GitHub discussion text. Use the links above for context.