website/docs: add a new page to help people get started after install is complete by tanberry · Pull Request #19217 · goauthentik/authentik

tanberry · 2026-01-06T23:14:40Z

This PR will add a tutorial style doc to help people get going after they finish installing authentik.

The documentation has been updated
The documentation has been formatted (make docs)

netlify · 2026-01-06T23:15:43Z

✅ Deploy Preview for authentik-storybook ready!

Name	Link
🔨 Latest commit	`dd907a1`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-storybook/deploys/69834c25eee5dd000860ab4e
😎 Deploy Preview	https://deploy-preview-19217--authentik-storybook.netlify.app
📱 Preview on mobile	Toggle 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 · 2026-01-06T23:16:24Z

✅ Deploy Preview for authentik-docs ready!

Name	Link
🔨 Latest commit	`8703355`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-docs/deploys/698350298e8c90000841f629
😎 Deploy Preview	https://deploy-preview-19217--authentik-docs.netlify.app
📱 Preview on mobile	Toggle 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 · 2026-01-06T23:16:36Z

✅ Deploy Preview for authentik-integrations ready!

Name	Link
🔨 Latest commit	`8703355`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-integrations/deploys/69835029d1c51e00082ee224
😎 Deploy Preview	https://deploy-preview-19217--authentik-integrations.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

codecov · 2026-01-06T23:23:52Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.25%. Comparing base (a908704) to head (070327b).
⚠️ Report is 23 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #19217   +/-   ##
=======================================
  Coverage   93.24%   93.25%           
=======================================
  Files         968      968           
  Lines       53429    53429           
=======================================
+ Hits        49822    49827    +5     
+ Misses       3607     3602    -5

Flag	Coverage Δ
conformance	`38.05% <ø> (+<0.01%)`	⬆️
e2e	`44.05% <ø> (+<0.01%)`	⬆️
integration	`22.76% <ø> (+<0.01%)`	⬆️
unit	`91.40% <ø> (+<0.01%)`	⬆️
unit-migrate	`91.42% <ø> (+<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.

website/docs/install-config/first-steps/index.mdx

website/docs/install-config/install/docker-compose.mdx

website/docs/install-config/install/kubernetes.md

website/docs/install-config/install/docker-compose.mdx

github-actions · 2026-01-07T22:38:42Z

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-070327ba2b53079cfe7bdca79df4739d77c02107
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-070327ba2b53079cfe7bdca79df4739d77c02107

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

Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

authentik-automation · 2026-01-14T23:09:04Z

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 83.3%, saving 220.0 KB.

Filename	Before	After	Improvement	Visual comparison
`website/docs/install-config/workflow_first_steps.drawio.png`	117.9 KB	18.5 KB	84.3%	View diff
`website/docs/install-config/install/docker.drawio.png`	76.3 KB	14.3 KB	81.3%	View diff
`website/docs/install-config/install/kubernetes.drawio.png`	69.9 KB	11.2 KB	83.9%	View diff

authentik-automation · 2026-01-14T23:09:34Z

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 6.9%, saving 1.8 KB.

Filename	Before	After	Improvement	Visual comparison
`website/docs/install-config/install/docker.drawio.png`	14.3 KB	13.1 KB	8.2%	View diff
`website/docs/install-config/install/kubernetes.drawio.png`	11.2 KB	10.6 KB	5.2%	View diff

1 image did not require optimisation.

authentik-automation · 2026-01-14T23:10:01Z

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 6.9%, saving 920 B.

Filename	Before	After	Improvement	Visual comparison
`website/docs/install-config/install/docker.drawio.png`	13.1 KB	12.2 KB	6.9%	View diff

2 images did not require optimisation.

Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

website/docs/users-sources/groups/manage_groups.mdx

dominic-r · 2026-02-03T16:03:16Z

website/docs/install-config/install/kubernetes.md

-        ingressClassName: nginx | traefik | kong
+    gateway:
+        # Specify kubernetes gateway controller class name
+        GatewayClassName: nginx | traefik | kong


Suggested change

GatewayClassName: nginx | traefik | kong

GatewayClassName: nginx # traefik, kong, or other

Is that the syntax, with a hash ??

It denotes a comment, and using | is inaccurate as only one value can be set and others outside of those listed can be as well

website/docs/install-config/install/kubernetes.md

website/docs/install-config/install/docker-compose.mdx

website/docs/add-secure-apps/applications/manage_apps.mdx

website/docs/add-secure-apps/bindings-overview/index.md

…ou can bind to yeehaw

Made most of the changes, some (like the Podman stuff) will need to go in a future PR

This cherry-pick has conflicts that need manual resolution. Original PR: #19217 Original commit: 3fd278e

authentik-automation · 2026-02-05T17:34:38Z

⚠️ Cherry-pick to version-2025.12 has conflicts: #20061

This cherry-pick has conflicts that need manual resolution. Original PR: #19217 Original commit: 3fd278e

tanberry added 5 commits January 5, 2026 17:30

new first steps docs

8bb702b

moved email config up to match Docker

ec2b9ba

Merge branch 'main' into docs-first-steps

e8996c9

first draft

c58d7ff

moved sections and retitled some

c9a2405

tanberry requested a review from a team as a code owner January 6, 2026 23:14

tanberry marked this pull request as draft January 6, 2026 23:14

dominic-r reviewed Jan 6, 2026

View reviewed changes

website/docs/install-config/first-steps/index.mdx Show resolved Hide resolved

dewi-tik reviewed Jan 7, 2026

View reviewed changes

website/docs/install-config/install/docker-compose.mdx Outdated Show resolved Hide resolved

website/docs/install-config/install/kubernetes.md Outdated Show resolved Hide resolved

website/docs/install-config/install/docker-compose.mdx Outdated Show resolved Hide resolved

tanberry mentioned this pull request Jan 7, 2026

"First steps" docs page #19191

Open

tanberry added 2 commits January 7, 2026 16:02

more content, tweaks

f120e17

dewis edits

297d4ca

tanberry added 2 commits January 8, 2026 20:19

added Dewi ideas, more content, tweaks

ee11194

more content, green tips, other fixes

9ce75e0

tanberry requested a review from BeryJu January 14, 2026 22:53

tanberry and others added 2 commits January 14, 2026 18:08

Merge branch 'main' into docs-first-steps

9d210d9

Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Optimised images with calibre/image-actions

0fd8069

Optimised images with calibre/image-actions

7858ab8

Optimised images with calibre/image-actions

a473d06

tanberry marked this pull request as ready for review January 21, 2026 20:17

tanberry and others added 2 commits January 21, 2026 15:19

Merge branch 'main' into docs-first-steps

b31517c

conflicts?

597a670

tanberry and others added 5 commits February 2, 2026 13:44

more link fixing

45cdf97

fix heading size

1e7e4d1

more dewi and dominic edits

c42dad5

Merge branch 'main' into docs-first-steps

bd72cb2

Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Merge branch 'main' into docs-first-steps

6f87b9c

tanberry requested a review from dominic-r February 3, 2026 15:59