Skip to content

website/docs: add info about make install and recovery key#20447

Merged
tanberry merged 9 commits intomainfrom
docs-dev-docs
Feb 23, 2026
Merged

website/docs: add info about make install and recovery key#20447
tanberry merged 9 commits intomainfrom
docs-dev-docs

Conversation

@tanberry
Copy link
Contributor

@tanberry tanberry commented Feb 20, 2026

This PR adds a tip to the Writing Docs page, about running make install if make docs-install is not sufficient. It also adds a troubleshooting section tot he Full Dev setup docs, about how to get a recovery key.

closes #19171

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

@tanberry tanberry requested a review from a team as a code owner February 20, 2026 19:47
@netlify
Copy link

netlify bot commented Feb 20, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit 4578d60
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/699c9983dc5f72000804a422
😎 Deploy Preview https://deploy-preview-20447--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 Feb 20, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 4578d60
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/699c9983e9878d00088c3065
😎 Deploy Preview https://deploy-preview-20447--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.

Signed-off-by: Dominic R <dominic@sdko.org>
@github-actions
Copy link
Contributor

github-actions bot commented Feb 20, 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-4578d60d1b64cf57bcae745af677a860c4e94930
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-4578d60d1b64cf57bcae745af677a860c4e94930

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

@codecov
Copy link

codecov bot commented Feb 20, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.30%. Comparing base (72a9a1a) to head (4578d60).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #20447      +/-   ##
==========================================
+ Coverage   93.29%   93.30%   +0.01%     
==========================================
  Files         981      981              
  Lines       55279    55279              
==========================================
+ Hits        51570    51577       +7     
+ Misses       3709     3702       -7     
Flag Coverage Δ
conformance 37.38% <ø> (+<0.01%) ⬆️
e2e 43.18% <ø> (+0.21%) ⬆️
integration 22.39% <ø> (+<0.01%) ⬆️
unit 91.49% <ø> (-0.02%) ⬇️
unit-migrate 91.53% <ø> (+<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.

@tanberry tanberry dismissed dominic-r’s stale review February 23, 2026 14:28

We can address the second comment in a second PR if we come to conclusion

@netlify
Copy link

netlify bot commented Feb 23, 2026

Deploy Preview for authentik-storybook ready!

Name Link
🔨 Latest commit 8f378c6
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/699c969c307ac6000812e555
😎 Deploy Preview https://deploy-preview-20447--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.

@tanberry tanberry merged commit 991f5fc into main Feb 23, 2026
101 checks passed
@tanberry tanberry deleted the docs-dev-docs branch February 23, 2026 19:19
@tanberry tanberry added the backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2 label Feb 23, 2026
authentik-automation bot pushed a commit that referenced this pull request Feb 23, 2026
* add info about make install and recovery key

* fix formatting on troubleshooting tip

* Apply suggestion from @dominic-r

Signed-off-by: Dominic R <dominic@sdko.org>

* tweak to bump

* tweak

* tweaked words abouot make install per jens

* build

---------

Signed-off-by: Dominic R <dominic@sdko.org>
Co-authored-by: Dominic R <dominic@sdko.org>
Co-authored-by: Marcelo Elizeche Landó <marcelo@goauthentik.io>
@authentik-automation
Copy link
Contributor

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

@authentik-automation
Copy link
Contributor

Cherry-pick to version-2026.2 already exists: #20486

kensternberg-authentik added a commit that referenced this pull request Feb 24, 2026
* main: (104 commits)
  sources/saml: improve exception handling for saml response parsing (#20125)
  web/flow: separate flow inspector lifecycle from flow executor lifecycle (#20063)
  web/maintenance: no unknown attributes part 2 (#19014)
  website/docs: add info about make install and recovery key (#20447)
  web: bump ajv from 6.12.6 to 6.14.0 in /web (#20479)
  providers/proxy: preserve URL-encoded path characters in redirect (#20476)
  policies: measure policy process from manager (#20477)
  enterprise: monkey patch pyjwt to accept mismatching key (#20402)
  enterprise/lifecycle: use datetime instead of date to track review cycles (#20283)
  root: run `npm i` with `npm@11.10.1` in all subdirectories (#20471)
  providers/oauth2: device code flow client id via auth header (#20457)
  core: bump goauthentik/fips-debian from `4419749` to `d6def0a` in /lifecycle/container (#20467)
  core: bump goauthentik/fips-python from `d973c46` to `bccefee` in /lifecycle/container (#20466)
  core, web: bump ajv from 6.12.6 to 6.14.0 in /packages/prettier-config (#20462)
  ci: bump and fix daily (#20461)
  website/integrations: fix Vaultwarden SSO_SCOPES syntax (#20459)
  stages/user_login: log correct user when session binding is broken (#20094)
  web/flow: generate a single API object for network transactions and use it for the lifetime of the FlowExecutor (#20030)
  web/flow: refactor flow executor so component selection is in an easy-to-maintain table (#19999)
  website/integrations: gatus: fix config block  (#20446)
  ...
gergosimonyi pushed a commit that referenced this pull request Feb 24, 2026
#20447 to version-2026.2) (#20486)

website/docs: add info about make install and recovery key (#20447)

* add info about make install and recovery key

* fix formatting on troubleshooting tip

* Apply suggestion from @dominic-r



* tweak to bump

* tweak

* tweaked words abouot make install per jens

* build

---------

Signed-off-by: Dominic R <dominic@sdko.org>
Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com>
Co-authored-by: Dominic R <dominic@sdko.org>
Co-authored-by: Marcelo Elizeche Landó <marcelo@goauthentik.io>
kensternberg-authentik added a commit that referenced this pull request Feb 25, 2026
…/soc-captchas-and-webauthn

* web/flow/20261-tidy-identification-stage: (107 commits)
  Added some visibility keys, as per @GirlBossRush
  sources/saml: improve exception handling for saml response parsing (#20125)
  web/flow: separate flow inspector lifecycle from flow executor lifecycle (#20063)
  web/maintenance: no unknown attributes part 2 (#19014)
  website/docs: add info about make install and recovery key (#20447)
  web: bump ajv from 6.12.6 to 6.14.0 in /web (#20479)
  providers/proxy: preserve URL-encoded path characters in redirect (#20476)
  Weird merge bug: same function appeared twice.
  policies: measure policy process from manager (#20477)
  enterprise: monkey patch pyjwt to accept mismatching key (#20402)
  enterprise/lifecycle: use datetime instead of date to track review cycles (#20283)
  root: run `npm i` with `npm@11.10.1` in all subdirectories (#20471)
  providers/oauth2: device code flow client id via auth header (#20457)
  core: bump goauthentik/fips-debian from `4419749` to `d6def0a` in /lifecycle/container (#20467)
  core: bump goauthentik/fips-python from `d973c46` to `bccefee` in /lifecycle/container (#20466)
  core, web: bump ajv from 6.12.6 to 6.14.0 in /packages/prettier-config (#20462)
  ci: bump and fix daily (#20461)
  website/integrations: fix Vaultwarden SSO_SCOPES syntax (#20459)
  stages/user_login: log correct user when session binding is broken (#20094)
  web/flow: generate a single API object for network transactions and use it for the lifetime of the FlowExecutor (#20030)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Instructions for setting up docs dev environment is incomplete

3 participants