Skip to content

website/docs: update kubernetes install guide for Gateway API#20961

Merged
dominic-r merged 2 commits intomainfrom
sdko/fix-k8s-install-docs-gateway-api
Mar 19, 2026
Merged

website/docs: update kubernetes install guide for Gateway API#20961
dominic-r merged 2 commits intomainfrom
sdko/fix-k8s-install-docs-gateway-api

Conversation

@dominic-r
Copy link
Member

@dominic-r dominic-r commented Mar 18, 2026

Replace the old server.gateway example with the current server.route.main configuration and clarify that the Gateway resource must be created separately.

Also: keep an Ingress fallback example for clusters without Gateway API support.

Replace the old `server.gateway` example with the current
`server.route.main` configuration and clarify that the Gateway
resource must be created separately.

Also: keep an Ingress fallback example for clusters without
Gateway API support.
@dominic-r dominic-r requested a review from a team as a code owner March 18, 2026 01:16
@dominic-r dominic-r changed the title Update Kubernetes install docs for Ingress and Gateway API website/docs: update kubernetes install guide for Gateway API Mar 18, 2026
@netlify
Copy link

netlify bot commented Mar 18, 2026

Deploy Preview for authentik-storybook ready!

Name Link
🔨 Latest commit f97724f
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/69b9fcebdeec7f000810658f
😎 Deploy Preview https://deploy-preview-20961--authentik-storybook.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@dominic-r dominic-r self-assigned this Mar 18, 2026
@dominic-r dominic-r added area:docs Features or issues related to Docusaurus backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2 labels Mar 18, 2026
@netlify
Copy link

netlify bot commented Mar 18, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit 19a18e1
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/69bb4ed79fba7d000806c054
😎 Deploy Preview https://deploy-preview-20961--authentik-integrations.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@netlify
Copy link

netlify bot commented Mar 18, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 19a18e1
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/69bb4ed7e658c700089db9e8
😎 Deploy Preview https://deploy-preview-20961--authentik-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@github-actions
Copy link
Contributor

github-actions bot commented Mar 18, 2026

authentik PR Installation instructions

Instructions for docker-compose

Add the following block to your .env file:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-19a18e1ff8a3cb137e1778f52fbebef251ffb7d4
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

Afterwards, run the upgrade commands from the latest release notes.

Instructions for Kubernetes

Add the following block to your values.yml file:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-19a18e1ff8a3cb137e1778f52fbebef251ffb7d4

Afterwards, run the upgrade commands from the latest release notes.

@codecov
Copy link

codecov bot commented Mar 18, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.49%. Comparing base (ee391b9) to head (19a18e1).
⚠️ Report is 21 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #20961   +/-   ##
=======================================
  Coverage   93.48%   93.49%           
=======================================
  Files         993      993           
  Lines       56126    56146   +20     
=======================================
+ Hits        52471    52492   +21     
+ Misses       3655     3654    -1     
Flag Coverage Δ
conformance 37.39% <ø> (-0.01%) ⬇️
e2e 42.88% <ø> (-0.02%) ⬇️
integration 22.21% <ø> (-0.01%) ⬇️
unit 91.69% <ø> (+<0.01%) ⬆️
unit-migrate 91.79% <ø> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@BeryJu
Copy link
Member

BeryJu commented Mar 18, 2026

I'd rather keep both of them for people that haven't migrated away from ingress yet, but seems that our ingress docs got broken in https://github.com/goauthentik/authentik/pull/19217/changes#diff-8d59f1f5bad5e5cb3c2e4967c920f514a8486edabecb788cfc62a2897c279dc6R45-R48

so need to revert that gateway to ingress

Copy link
Contributor

@dewi-tik dewi-tik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One tiny change otherwise LGTM

@github-project-automation github-project-automation bot moved this from Todo to In Progress in authentik Core Mar 18, 2026
@dewi-tik dewi-tik moved this from In Progress to Needs review in authentik Core Mar 18, 2026
@github-project-automation github-project-automation bot moved this from Needs review to In Progress in authentik Core Mar 18, 2026
@dominic-r dominic-r requested a review from BeryJu March 19, 2026 01:22
@dominic-r dominic-r enabled auto-merge (squash) March 19, 2026 01:45
@dominic-r dominic-r merged commit 31261e1 into main Mar 19, 2026
101 of 102 checks passed
@dominic-r dominic-r deleted the sdko/fix-k8s-install-docs-gateway-api branch March 19, 2026 01:46
@github-project-automation github-project-automation bot moved this from In Progress to Done in authentik Core Mar 19, 2026
@authentik-automation
Copy link
Contributor

🍒 Cherry-pick to version-2026.2 created: #20997

dominic-r added a commit that referenced this pull request Mar 19, 2026
…-pick #20961 to version-2026.2) (#20997)

Co-authored-by: Dominic R <dominic@sdko.org>
kensternberg-authentik added a commit that referenced this pull request Mar 24, 2026
* main:
  web: link file picker to docs (#20995)
  web/flow: reset stale authenticator selection between consecutive validate stages (#20802)
  ci: bump actions/cache from 5.0.3 to 5.0.4 (#21002)
  root: init rust workspace (#20983)
  website/docs: fix swapped sidebar label (#21011)
  core: bump goauthentik/fips-python from `ec5c4cd` to `859ad57` in /lifecycle/container (#21003)
  core: bump goauthentik/fips-debian from `a613b75` to `7baeeaa` in /lifecycle/container (#21001)
  core: bump djangorestframework from 3.16.1 to 3.17.0 (#21000)
  lifecycle/aws: bump aws-cdk from 2.1111.0 to 2.1112.0 in /lifecycle/aws (#20999)
  ci: bump codecov/codecov-action from 5.5.2 to 5.5.3 in /.github/actions/test-results (#21004)
  web: bump the storybook group across 1 directory with 5 updates (#21005)
  web: bump knip from 5.87.0 to 5.88.0 in /web (#21006)
  web: bump @formatjs/intl-listformat from 8.2.3 to 8.3.1 in /web (#21007)
  website/docs: update kubernetes install guide for Gateway API (#20961)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Features or issues related to Docusaurus backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

4 participants