Skip to content

fix an error in the k8s quickstart instructions - #2362

Merged
kenjenkins merged 2 commits into
mainfrom
kenjenkins/k8s-quickstart-error
Sep 11, 2026
Merged

fix an error in the k8s quickstart instructions#2362
kenjenkins merged 2 commits into
mainfrom
kenjenkins/k8s-quickstart-error

Conversation

@kenjenkins

Copy link
Copy Markdown
Contributor

Summary

To use provider: hosted we need to set an Authenticate Service URL. The quickstart already has instructions for generating an mkcert wildcard certificate, so we can use a sub-domain for this URL.

Related

https://linear.app/pomerium/issue/ENG-4392/docs-ingress-controller-quickstart-example-leads-to-error

AI disclosure

none

Checklist

  • reference any related issues
  • disclosed AI usage (or wrote "none") per AI_POLICY.md

To use 'provider: hosted' we need to set an Authenticate Service URL.
The quickstart already has instructions for generating an 'mkcert'
wildcard certificate, so we can use a sub-domain for this URL.
@netlify

netlify Bot commented Sep 11, 2026

Copy link
Copy Markdown

Deploy Preview for pomerium-docs ready!

Name Link
🔨 Latest commit d724fa9
🔍 Latest deploy log https://app.netlify.com/projects/pomerium-docs/deploys/6aa452ed61abe600083e0fd3
😎 Deploy Preview https://deploy-preview-2362--pomerium-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Correct and simplify the note at the top about the Hosted Authenticate
Service, and style it as a Tip. Link directly to the relevant sections
of the combined Authentication page.

Tweak formatting in the 'Install Pomerium' section so that the
instructions nest under the list items.
@kenjenkins
kenjenkins marked this pull request as ready for review September 11, 2026 19:14
@kenjenkins
kenjenkins requested a review from a team as a code owner September 11, 2026 19:14
@greptile-apps

greptile-apps Bot commented Sep 11, 2026

Copy link
Copy Markdown

Greptile Summary

This PR corrects the Kubernetes quickstart configuration for the Hosted Authenticate Service.

  • Configures an Authenticate Service URL under spec.authenticate.
  • Uses the existing wildcard localhost domain and certificate flow for the Authenticate endpoint.
  • Updates the quickstart explanation, links, formatting, and verification URL.

Confidence Score: 5/5

The documentation change appears safe to merge.

The added configuration matches the documented Kubernetes CRD, the Hosted Authenticate flow, and the quickstart's existing wildcard domain and certificate setup; no actionable failure remains.

Important Files Changed

Filename Overview
content/docs/deploy/k8s/quickstart.mdx Updates the Hosted Authenticate guidance and walks users through the new localhost Authenticate endpoint with valid links and consistent MDX formatting.
content/examples/kubernetes/pomerium-global-settings.md Adds the required spec.authenticate.url setting to the quickstart's sole global-settings example.

Reviews (1): Last reviewed commit: "minor improvements" | Re-trigger Greptile

@kenjenkins
kenjenkins merged commit f4e530a into main Sep 11, 2026
10 checks passed
@kenjenkins
kenjenkins deleted the kenjenkins/k8s-quickstart-error branch September 11, 2026 19:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants