diff --git a/website/docs/troubleshooting/login.md b/website/docs/troubleshooting/login.md new file mode 100644 index 000000000..07136f0bc --- /dev/null +++ b/website/docs/troubleshooting/login.md @@ -0,0 +1,23 @@ +--- +title: Troubleshooting Login problems +--- + +In case you can't login anymore, perhaps due to an incorrectly configured stage or a failed flow import, you can create a recovery key. + +:::caution +This recovery key will give whoever has the link direct access to your instances. Keep this key safe. +::: + +To create the key, run the following command: + +``` +docker-compose run --rm server create_recovery_key 10 akadmin +``` + +or, for Kubernetes, run + +``` +kubectl exec -it authentik-web- -- ./manage.py create_recovery_key 10 akadmin +``` + +This will output a link, that can be used to instantly gain access to authentik as the user specified above. The link is valid for amount of years specified above, in this case, 10 years. diff --git a/website/sidebars.js b/website/sidebars.js index fe281538e..1ecace20e 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -149,6 +149,7 @@ module.exports = { items: [ "troubleshooting/access", "troubleshooting/emails", + "troubleshooting/login", ], }, {