Authentication: remove .storage section (#30408)

This commit is contained in:
c0ffeeca7 2023-12-19 11:09:27 +01:00 committed by GitHub
parent f400511d03
commit 2794e55ffd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 5 additions and 22 deletions

View File

@ -76,17 +76,7 @@ INFO (MainThread) [homeassistant.components.http.auth] You need to use a bearer
### Lost owner password ### Lost owner password
Before using the procedure below, make sure you explore options provided [here](/docs/locked_out). 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).
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.
### Error: invalid client id or redirect URL ### Error: invalid client id or redirect URL

View File

@ -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 ### 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 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 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 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 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) ## Recovering data for Home Assistant (including Supervised)

View File

@ -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). - 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. - 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**. 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) ![Set your username and password.](/images/getting-started/username.png)