The reset procedure clears the data disk on your device. Unless you created a backup, you will lose all data and configuration settings.

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, reset the device using an SD card. To see which version you have, go to Settings > About.

Performing a factory reset of your device is an extreme measure that should not usually be required and should be done with caution.

Considerations before starting a reset

The reset process requires a working internet connection.

• If your Green can't reach the internet, the reset will fail, leaving you worse off than when you started.

Common issues that don't require a reset

• Can't remember your password: Reset your owner password.
• Can't find your device on the network: Check your router's device list for the current IP address.
• Device seems unresponsive: Power cycle and wait 5 minutes for a full boot.

If you're unsure what's causing your issue, consider asking the Home Assistant Community before resetting your device.

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.

To reset the device

Step 1

Shutting down the system

1. 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.
2. 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.
3. Remove the power cable to remove power from the system.

Step 2

Powering up the system

1. 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
2. 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.

  1. Installing the app.

     • To access Home Assistant from your mobile device, use the QR code to locate the app in the app store.

  2. 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.

  3. The Home Assistant user interface guides you through the initial onboarding.

     • Info For further information, refer to the instructions.

  4. 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.

Related topics

• Creating a backup
• Onboarding
• Can't access homeassistant.local:8123