diff --git a/source/_docs/authentication.markdown b/source/_docs/authentication.markdown index bb575db1b7e..7bae172053b 100644 --- a/source/_docs/authentication.markdown +++ b/source/_docs/authentication.markdown @@ -37,3 +37,15 @@ Once you're logged in, you can access the profile page by clicking on the badge As a user, you can setup multi-factor authentication with time-based one-time passwords. This is an extra challenge that you have to solve after you finish your login. You will be able to set up these challenges from the profile page once you're logged in. Screenshot of setting up multi-factor authentication + +## {% linkable_title Troubleshooting %} + +### {% linkable_title Lost owner password %} + +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](https://www.home-assistant.io/docs/configuration/): + +* `auth` +* `auth_provider.homeassistant` +* `onboarding` + +When you start Home Assistant next you'll be required to set up authentication again.