Skip to content

2.3 Upgrading HOOBS

Michael Kellsy edited this page Nov 22, 2019 · 12 revisions

It is highly recommended to backup your Homebridge config files.

If you have a previous version of HOOBS or you have the homebridge-config-ui-x plugin installed you can use this method to upgrade. If you have a different setup, please follow the instructions in the Upgrading Manually section.

Installing the Migration Utility

We have created a Homebridge plugin that starts the upgrade process.

  1. From the interface navigate to the Plugins section.

  2. Search for homebridge-to-hoobs and click the Install button.

  1. This will start the plugin install. (Installation can take several minutes - be patient)

  1. Once the plugin finishes. You will see the message Please Refresh Your Browser.

Known Issues: Upgrading also upgrades Node. If your current Node version is less then the required version of HOOBS, the install may fail. If it does, just repeat these steps.

The Reboot Process

Rebooting the server can take a several minutes. You might see a screen like this while the server reboots.

This screen will automatically refresh, and the screen will look like this while HOOBS initializes.

The initialization process may take up to 10 minutes, or longer depending on how many plugins you have installed. Once it finishes, you will see the login screen.

Your users and passwords are automatically migrated over along with all of your plugins and configuration.

Next Steps

Congratulations you have upgraded HOOBS. Now let us walk you through the User Interface.

You can’t perform that action at this time.