¶ Soft Reset
¶ What is a Soft Reset?
A soft reset erases the main database on your hub, which contains your settings, device list, custom code, and other configuration. It does not reset the Z-Wave or Zigbee radios. It is generally a safe procedure to perform, and if you download a backup and then restore it afterwards, your hub should function as before. If you suspect database corruption, a soft reset and restore can be a useful troubleshooting step.
¶ How to Perform a Soft Reset
-
If your hub is functional, navigate to Settings > Diagnostic Tool. If your hub is not functional, navigate to http://[Your Hub IP]:8081. Either method will take you to the Hubitat Diagnostic Tool main page.
- NOTE: Replace [Your Hub IP] with the IP address of your hub. You must use the IP address and not a hostname.
-
Log in with the MAC address of your hub, if prompted.
- This is available from Settings > Hub Details (if the regular hub interface is accessible) or from the sticker on the bottom of the hub.
- This is not case-sensitive but must include colons as separators (e.g., 34:E1:D1:80:12:34).
-
Select the Soft Reset option:
-
Type soft reset in the box to confirm, and select Soft reset to begin.
-
Once the soft reset has completed, the hub will restart, and you will automatically be redirected to the setup page.
¶ Restoring a Previous Database
The following two steps are required if you are restoring previous hub settings from a backup.
- Select the Restore from Backup? link at the bottom of the "Get Started" page when the hub reboots following the soft reset.
- Follow the prompts to restore the database, or see How to Restore from Local Backup for more information.
- Select Settings page in the sidebar.
- Select Reboot.
NOTE: Database backups do not include File Manager files. These should be backed up and restored separately, if so desired.
¶ What About a "Full Reset"?
For the equivalent of a "full reset," you can perform the following:
- Reset the Z-Wave and/or Zigbee radios from Settings > Z-Wave Details and Settings > Zigbee Details (if used).
- Remove any files from Settings > File Manager and the Device Firmware Updater app (if used).
- Delete all local backups from Settings > Backup and Restore.
- De-register your hub (if registered) using the "de-register hub" option under Registered Hubs at my.hubitat.com (note that the hub must be currently connected to the Internet for this option to appear, and the hub cannot have any active subscriptions).
- If you have configured non-default network settings on the hub in Settings > Network Setup, such as a static IP or Wi-Fi configuration, undo them or perform a network reset.
- Finally, perform a soft reset, as described above. Ensure the Also clear past logs option is selected.
These extra steps are not necessary in most cases and will require re-pairing all devices, even if a database backup is restored (except for Hub Protect backups). Perform these steps with caution. These steps are not necessary for a regular soft reset.
WARNING: Do not reset the Zigbee or Z-Wave radios to perform a soft reset. This will require re-pairing all devices like new.