Skip to content

docs(ngf): add clarification on listener certificateRefs - #2176

Open
pvillaverde wants to merge 1 commit into
nginx:mainfrom
pvillaverde:ngfx/add-clarification-on-listener-certificate-refs
Open

docs(ngf): add clarification on listener certificateRefs#2176
pvillaverde wants to merge 1 commit into
nginx:mainfrom
pvillaverde:ngfx/add-clarification-on-listener-certificate-refs

Conversation

@pvillaverde

Copy link
Copy Markdown

Proposed changes

Add a clarification note to the cert-manager integration guide to clarify how multiple certificateRefs on an HTTPS Listener are handled based on nginx/nginx-gateway-fabric#5647

The current documentation may lead readers to expect that certificates are automatically selected based on the hostnames of attached HTTPRoute resources. In practice, certificateRefs are associated with the Listener, not individual routes. When different domains require different TLS certificates, separate HTTPS Listeners with distinct, non-overlapping hostname values are required.

This PR adds a short note to clarify this behavior and help users avoid hours of nightmare debugging trying to find what's wrong. I'm not sure if this is the best place to put it, but it's the one I would have found it when I checked the docs I think.

Checklist

Before sharing this pull request, I completed the following checklist:

Footnotes

  1. Potentially sensitive information includes personally identify information (PII), authentication credentials, and live URLs. Refer to the style guide for guidance about placeholder content.

@pvillaverde
pvillaverde requested a review from a team as a code owner July 28, 2026 16:56
@github-actions github-actions Bot added documentation Improvements or additions to documentation product/ngf Issues related to NGINX Gateway Fabric labels Jul 28, 2026
@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown

✅ All required contributors have signed the F5 CLA for this PR. Thank you!
Posted by the CLA Assistant Lite bot.

@pvillaverde

Copy link
Copy Markdown
Author

I have hereby read the F5 CLA and agree to its terms

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation product/ngf Issues related to NGINX Gateway Fabric

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants