jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-21 08:16:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update locked_out.md (#16037)

Browse Source 
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Ken Guest 2021-01-25 14:40:37 +00:00 committed by GitHub
parent 2f25988e27
commit c97da3f3a8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 23 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
source/_docs/locked_out.md
View File

@ -10,16 +10,36 @@ or need to recover your data.
### Home Assistant (including Supervised)
If you are still logged in to the web interface with your user, then you are in luck. Add a new user as an administrator and give the new user a password you can remember. Then log out, and log in with this new user. You may then delete the old user account. But this way, your configuration will remain, and you don't have to do a new onboarding process.
If you are still logged in to the web interface with your user, then you are in luck. Add a new user as an administrator and give the new user a password you can remember. Then log out, and log in with this new user. You may then reset your password via this new administrator account (and then delete this new account), or you can delete your old user account. Either way, your configuration will remain, and you don't have to do a new onboarding process.
If you’ve forgotten your user, then deleting the files mentioned above will be necessary to start a new onboarding process.
If you’ve forgotten your username, then deleting the files mentioned above will be necessary to start a new onboarding process.
If you know the user, but not the password and you can access the [Home Assistant console](https://www.home-assistant.io/hassio/commandline/) and use the command below:
#### To reset a user's password, via console
If you know the username, but not the password and you can access the [Home Assistant console](https://www.home-assistant.io/hassio/commandline/) and use the command below:
Connect a keyboard and monitor to your device.
`auth reset --username existing_user --password new_password`
#### To reset a user's password, as an administrator via the web interface
1. Click "Configuration" in the sidebar.
2. Scroll down to "Users", and click in to that section.
3. Click on the user, this should bring up a dialog box.
4. At the bottom of the dialog box, click "Change Password".
5. Enter the new password, and then click "OK".
6. Confirm the new password by entering it again, and then click "OK" again.
7. A confirmation box will be displayed with the text "Password was changed successfully".
#### To delete a user, as an administrator via the web interface
1. Click "Configuration" in the sidebar.
2. Scroll down to "Users", and click in to that section.
3. Click on the user, this should bring up a dialog box.
4. At the bottom of the dialog box, click "Delete User".
5. A confirmation dialog box will be displayed, asking "Are you sure you want to delete <User>"?
6. Click "OK".
### Home Assistant Core and Home Assistant Container
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/):