Adds locked_out.md (#12079)

* Adds locked_out.md Adds documentation for options when locked out or needing to recover files * Adds meta data * ✏️ Tweak * fix incorrect terms * fix typo * ✏️ Tweaks * ✏️ Tweak * ✏️ Tweaks Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com> Co-authored-by: Franck Nijhof <frenck@frenck.nl>
2025-07-23 17:27:19 +00:00 · 2020-02-14 01:41:03 -07:00 · 2020-02-14 01:41:03 -07:00 · 993689bdbe
commit 993689bdbe
parent c55a40d5ea
1 changed files with 64 additions and 0 deletions
--- a/source/_docs/locked_out.md
+++ b/source/_docs/locked_out.md
@ -0,0 +1,64 @@
+---
+title: "I'm Locked Out!"
+description: "Options for regaining access"
+---
+
+The sections below deal with recovering from a situation where you are not able to sign in,
+or need to recover your data.
+
+## Forgot Password
+
+### Home Assistant (including Supervised)
+
+If you’ve forgotten your user, 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:
+
+Connect a keyboard and monitor to your device.
+
+`ha auth reset --username "<existing_user>" --password "<new_password>"`
+
+### Home Assistant Core
+
+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`
+
+## Recovering Data for Home Assistant (including Supervised)
+
+Unless your SD card/data is corrupted, you can still get to your files or troubleshoot further. 
+There are a few routes:
+
+- Connect a USB keyboard and HDMI monitor directly to the Raspberry Pi.
+- Remove the SD and access the files from another machine (preferably one running Linux).
+
+## Connect directly
+
+If you’re using a Raspberry Pi, you're likely going to have to pull the power in order to get your monitor recognized at boot. Pulling power has a risk of corrupting the SD, but you may not have another option. Most standard USB keyboards should be recognized easily.
+
+Once you're connected, you'll see a running dmesg log. Hit the enter key to interrupt the log.
+Sign in as "root". There is no password.
+
+You will then be at the Home Assistant CLI, where you can run the custom commands. These are the same as you would run using the SSH addon but without using `ha` in front of it. For example:
+
+- `core logs` for Home Assistant Core log
+- `supervisor logs` for supervisor logs 
+- `host reboot` to reboot the host
+- `dns logs` for checking DNS
+- etc (typing `help` will show more)
+
+## Accessing Files from the SD/HDD
+
+### Remove the SD and access the files from another computer
+
+The files are on an EXT4 partition (`hassos-data`) and the path is `/mnt/data/supervisor`.
+These are easily accessed using another Linux machine with EXT support.
+
+For Windows or macOS you will need third party software. Below are some options.
+
+- Windows: https://www.diskinternals.com/linux-reader/ (read-only access to the SD)
+- Mac:  https://osxfuse.github.io/