From 2fdf345271b222d5fb1888ca0570fb5cc660d786 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcelo=20Elizeche=20Land=C3=B3?= Date: Tue, 17 Jun 2025 10:40:14 -0300 Subject: [PATCH] website/docs: Add steps to troubleshoot /initial-setup/ (#15011) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add steps to troubleshoot /initial-setup/ * fix linting * Apply suggestions from code review Co-authored-by: Dewi Roberts Signed-off-by: Marcelo Elizeche Landó * Apply suggestions from code review Co-authored-by: Dewi Roberts Signed-off-by: Marcelo Elizeche Landó * add email part * Apply suggestions from code review Co-authored-by: Dewi Roberts Signed-off-by: Marcelo Elizeche Landó * Apply suggestions from code review Co-authored-by: Tana M Berry Signed-off-by: Marcelo Elizeche Landó * change wording --------- Signed-off-by: Marcelo Elizeche Landó Co-authored-by: Dewi Roberts Co-authored-by: Tana M Berry --- website/docs/troubleshooting/login.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/website/docs/troubleshooting/login.md b/website/docs/troubleshooting/login.md index 2ebe75eec6..4d5e5b0e69 100644 --- a/website/docs/troubleshooting/login.md +++ b/website/docs/troubleshooting/login.md @@ -27,3 +27,29 @@ uv run ak 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. + +## Can't access initial setup flow during installation steps + +If you're unable to access the initial setup flow (`/if/flow/initial-setup/`) immediately after installing authentik, first try restarting the containers because this often resolves temporary issues. + +However, if the issue persists after restarting, you can directly set the admin password using the following commands: + +Docker Compose deployments: + + ```bash + docker compose exec server ak changepassword akadmin + ``` + +Kubernetes deployments: + + ```bash + kubectl exec -it deployment/authentik-server -c server -- ak changepassword akadmin + ``` + +After following the prompts to set a new password, you can then login via: `https://authentik.company/if/flow/default-authentication-flow/?next=%2F` + +After logging in, you can set the email address and other settings for the account by navigating to **Directory** > **Users** and editing the user account. + +:::note +This method bypasses the initial setup flow and should only be used as a last resort. The initial setup flow is the recommended method to configure the administrator user. +:::