From c735b07259bf9fb8c84ec5af8b45b83bde817a68 Mon Sep 17 00:00:00 2001 From: James Newton-King Date: Wed, 3 Aug 2022 16:20:47 +0800 Subject: [PATCH] Document dynamic port binding limitations (#26611) Co-authored-by: Stephen Halter --- aspnetcore/fundamentals/servers/kestrel/endpoints.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/aspnetcore/fundamentals/servers/kestrel/endpoints.md b/aspnetcore/fundamentals/servers/kestrel/endpoints.md index 34f3cab56d..451aab0ce3 100644 --- a/aspnetcore/fundamentals/servers/kestrel/endpoints.md +++ b/aspnetcore/fundamentals/servers/kestrel/endpoints.md @@ -419,6 +419,11 @@ When the port number `0` is specified, Kestrel dynamically binds to an available :::code language="csharp" source="samples/6.x/KestrelSample/Snippets/Program.cs" id="snippet_IServerAddressesFeature"::: +Dynamically binding a port isn't available in some situations: + +* `ListenLocalhost` +* Binding TCP-based HTTP/1.1 or HTTP/2, and QUIC-based HTTP/3 together. + ## Limitations Configure endpoints with the following approaches: