Perform this procedure if you have Home Assistant 13.1 or later and you want to do a factory reset. If you have a new device, you likely have an older version of Home Assistant Operating System (older than 13.1). In this case, Settings > About.
Prerequisites
- Home Assistant Green
- Home Assistant Operating System 13.1 or later installed.
- To see which version you have, go to Settings > About.
- PC with internet access
- You have created a backup and stored it on another system.
Notice
Risk of losing your data and configuration
- This process clears the data disk on your device. Unless you create a backup, you will lose all data and configuration settings.
- A device reset wipes the data partition. It removes all user data as well as Home Assistant Core, Supervisor, and any installed add-ons. The Home Assistant Operating System stays on the system.
- Once a device wipe is initiated, the data partition is marked as to be cleared on boot. Then, the system reinstalls the latest version of all Home Assistant components.
- To avoid losing data and configuration settings, create a backup and define a backup location outside of your Home Assistant.
To reset the device
Step 1
Shutting down the system
- In your Home Assistant UI, go to Settings > System and in the top right, select the three-dots menu. Select Restart Home Assistant.
- Then, select Shut down system.
- Wait until all the LEDs turned off.
- Important: It is important to wait until all the the LEDs turned off, indicating that the shutdown is complete. otherwise the reset will fail.
- In case the shutdown via UI should not work:
- To shutdown gracefully, press the power button for 6 seconds.
- For a hard shutdown (do this only if all else fails), press the power button for 12 seconds.
- Wait until all the LEDs turned off.
- Remove the power cable to remove power from the system.
Step 2
Powering up the system
- Press and hold the button.
- Reapply power and make sure the system has an Internet connection.
- Keep the button pressed until the yellow LED turns on solid.
- Troubleshooting: The yellow LED blinks, instead of turning on solid. This means you do not have the HAOS version required to perform this procedure. In this case, reset the device using an SD card
- Release the button.
- The LEDs start blinking.
- The Home Assistant Operating System now downloads the latest version of Home Assistant Supervisor and Home Assistant Core.
- Due to the downloads, it can take a while until Home Assistant becomes accessible again.
Step 3
Getting started with Home Assistant
-
Info Initial startup may take a while, depending on your internet connection.
-
Installing the app.
- To access Home Assistant from your mobile device, use the QR code to locate the app in the app store.
-
Selecting your Home Assistant server.
- Mobile: Confirm the IP address detected by the app. For example
http://192.168.1.196:8123 - Desktop: Visit http://homeassistant.local:8123 to access the Home Assistant user interface.
- Mobile: Confirm the IP address detected by the app. For example
-
The Home Assistant user interface guides you through the initial onboarding.
- Info For further information, refer to the instructions.
-
Troubleshooting: If after startup you do not see the onboarding screen, but the "normal" user interface, the reset failed.
- A likely cause is that you did not wait long enough for the shutdown to complete. Repeat the procedure.
- Another cause could be that the Green is running on OS 13.1 or older. In that case, resetting with this procedure does not work. Instead, use the reset the device using an SD card procedure.
-