From 2794e55ffd10455d88e1c43772c343fe7cc251dd Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Tue, 19 Dec 2023 11:09:27 +0100 Subject: [PATCH] Authentication: remove .storage section (#30408) --- source/_docs/authentication.markdown | 12 +----------- source/_docs/locked_out.md | 11 +---------- source/getting-started/onboarding.markdown | 4 +++- 3 files changed, 5 insertions(+), 22 deletions(-) diff --git a/source/_docs/authentication.markdown b/source/_docs/authentication.markdown index 22d53170647..29b8a313b44 100644 --- a/source/_docs/authentication.markdown +++ b/source/_docs/authentication.markdown @@ -76,17 +76,7 @@ INFO (MainThread) [homeassistant.components.http.auth] You need to use a bearer ### Lost owner password -Before using the procedure below, make sure you explore options provided [here](/docs/locked_out). - -While you should hopefully be storing your passwords in a password manager, if you lose the password associated with the owner account the only way to resolve this is to delete _all_ the authentication data. You do this by shutting down Home Assistant and deleting the following files from the `.storage/` folder in your [configuration folder](/docs/configuration/): - -- `auth` -- `auth_provider.homeassistant` -- `onboarding` -- `hassio` -- `cloud` - -When you start Home Assistant next, you'll be required to set up authentication again. +If you lose the password associated with the owner account, you need to [start a new onboarding process](/docs/locked_out/#to-prepare-the-system-to-start-a-new-onboarding-process). ### Error: invalid client id or redirect URL diff --git a/source/_docs/locked_out.md b/source/_docs/locked_out.md index c053addf667..dd4be294f07 100644 --- a/source/_docs/locked_out.md +++ b/source/_docs/locked_out.md @@ -89,22 +89,13 @@ You need to be an owner or have administrator rights to delete a user. ### To prepare the system to start a new onboarding process -If you lose the password associated with the owner account and the steps above do not work to reset the password, the only way to resolve this is to start a new onboarding process. +If you lose the password associated with the owner account and the steps above do not work to reset the password, the only way to resolve this is to start a new onboarding process. - If you have an external backup with an administrator account of which you still know the login credentials, you can restore that backup. - If you do not have a backup, resetting the device will erase all data. - If you have a Home Assistant Green, [reset the Green](https://green.home-assistant.io/guides/reset/). - If you have a Home Assistant Yellow, [reset the Yellow](https://yellow.home-assistant.io/guides/factory-reset/). -- If you have a Raspberry Pi, delete *all* the authentication data. - - Shut down Home Assistant. - - Remove your SD card and access it from your PC. - - Delete the following files from the `.storage/` folder in your [configuration folder](/docs/configuration/): - - `auth` - - `auth_provider.homeassistant` - - `onboarding` - - `hassio` - - `cloud` ## Recovering data for Home Assistant (including Supervised) diff --git a/source/getting-started/onboarding.markdown b/source/getting-started/onboarding.markdown index 24051d20fe7..e9df380e60b 100644 --- a/source/getting-started/onboarding.markdown +++ b/source/getting-started/onboarding.markdown @@ -26,7 +26,9 @@ We will now create the owner's account of Home Assistant. This account is an adm - Continue with the procedure on [restoring from backup](/common-tasks/os/#restoring-a-backup). - Ignore the rest of this procedure. The following steps describe how to create a new installation, not how to restore from backup. 2. If this is your initial installation, select **Create my smart home**. -3. Enter a name, username, and password. Select **Create account**. +3. Enter a name, username, and password. + - Store the name, username, and password in a password manager. There is no way to recover the owner credentials. + - Select **Create account**. ![Set your username and password.](/images/getting-started/username.png)