Performing a Soft Reset
A soft reset clears the hub’s main database, which includes your settings, device list, custom code, and other configurations. It does not affect the Z-Wave or Zigbee radios. Generally, it is a safe procedure, and if you download a backup beforehand and restore it afterward, your hub should return to its previous state. If you suspect database corruption, performing a soft reset followed by a restore can be an effective troubleshooting step.
- If your hub is functional, navigate to Settings > Diagnostic Tool.
Alternatively, if cannot access the regular hub interface, navigate to http://[Your Hub IP]:8081. Replace [Your Hub IP] with the IP address of your hub. You must use the IP address and not a hostname.
Either method will take you to the Hubitat Diagnostic Tool, there is no difference. - Log in with the MAC address of your hub, if prompted.
This is available from Settings > Hub Details 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). This is the MAC address for the wired interface. - 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.
Performing a Hard Reset
First, consider why you are thinking of performing this step. If you have a misbehaving device, for example, it is better to troubleshoot the device (or app, etc.). Please reach out if you require additional troubleshooting.
If you still want to proceed, you can perform the following:
- If you have a Hub Protect, Cloud Backup, or Remote Admin subscription associated with your old hub, move that service to another registered hub or cancel the subscription. (A full reset is not available for hubs with active subscriptions)
- Navigate to Settings > Diagnostic Tool.
- Select Advanced..., then select Full Reset. Read and confirm your understanding of all the warning prompts by selecting the appropriate buttons.
NOTE: If you do not see an
Advanced... button, your
Diagnostic Tool may be out-of-date. It should update on its own within a day or two (if connected to the Internet), or visit the
Diagnostic Tool documentation to see how to perform a manual update, here:
Hubitat Diagnostic Tool | Hubitat Documentation
This will reset the Zigbee and Z-Wave radios, remove your hub database (including all devices and settings), hub registration, and logs. Note that after a full reset, restoring a local backup will not fully restore your hub to previous functionality.
A full reset will not delete any Hubitat accounts you have created, although it will un-register your hub (you can use the same account to register a new hub or the same hub in the future).
Alternative to a Full Reset
In most situations, a full reset is not needed. In some cases, such as if you have an active Hub Protect subscription that you do not want to transfer or cancel, a full reset is not possible. However, you can achieve the same outcome by manually completing the necessary steps.
- Navigate to Settings > Diagnostic Tool.
- Select Advanced... to display more options. Read and confirm your understanding of all the warning prompts by selecting the appropriate buttons.
- Select Reset Zigbee Radio.
- Select Reset Z-Wave Radio.
- If using Matter (and you want to erase Matter configuration), navigate to Settings > Matter Details, change the URL ending with /hub/matterDetails to /hub/matterDetails?fullui=true, and select Reset Matter there.
- Remove any files from Settings > File Manager or Apps > Device Firmware Updater.
- Remove any local backups from Settings > Backup and Restore if you wish to remove them from the hub.
- 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 network reset.
- If desired, de-register your hub using the "de-register hub" option under Registered Hubs at my.hubitat.com (note that the hub must be connected to the Internet for this option to appear, and the hub cannot have any active subscriptions).
- From the Diagnostic Tool, perform a soft reset as outlined above.
Like a full reset, 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 or Cloud Backup backups). Perform these steps after careful consideration only.