Hub Connect Installation Instructions
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 3
HubConnect 1.0
Installation Instructions!
Multi-Platform, Real-Time Device Intercommunication
Minimum System Requirements:!
•1 Hubitat Hub (Coordinator).#
- AND -!
•1 Hubitat Hub (Remote)#
- OR -!
•1 SmartThings Hub (Remote)#
Please note that the HubConnect apps are not released under any open-source license. Be
sure to read the license agreement before installing.!
HUBCONNECT MULTIPLATFORM DEPLOYMENT
Before installing HubConnect it is important to designate one Hubitat hub to act as the the
coordinator or "server". The server hub will be responsible for managing the links to all of the
remote hubs, managing custom device drivers, and reporting the up/down status of the remote
hubs.!
On designated Server Hub, perform the following pre-installation steps:!
1. Install the HubConnect Server (container) app code by importing the file "Hubitat/apps/
HubConnect-Server.groovy".!
2. Install the HubConnect Server Instance app code by importing the file “Hubitat/apps/
HubConnect-Server-Instance.groovy”.!
1. Click the oAuth button, then click the Enable oAuth in App button.!
3. Install the HubConnect Remote Hub driver code by importing the file “Hubitat/drivers/
HubConnect-Remote-Hub.groovy".!
4. (optional) For large systems it may be advisable to pre-install all of the drivers located in
“UniversalDrivers/HubConnect-*.groovy”. For most environments, this step can be deferred
for now. HubConnect will advise as to which drivers are needed at the time of device
selection.!
5. Click “Apps”, “Add User App”.!
6. Select HubConnect Server.!
7. Hit “Done” when the screen updates.!
#
Once the Server or “coordinator” hub has been installed, install the HubConnect Remote Client
on all of the satellite hubs.!
Hubitat Remote Hub; perform the following pre-installation steps:!
1. Install the HubConnect Remote Client app by importing the file “Hubitat/apps/
HubConnect-Remote-Client.groovy”.!
1. Click the oAuth button, then click the Enable oAuth in App button.!
2. (optional) For large systems it may be advisable to pre-install all of the drivers located in
“UniversalDrivers/HubConnect-*.groovy”. For most environments, this step can be deferred
for now. HubConnect will advise as to which drivers are needed at the time of device
selection.!
3. Repeat this process for all Hubitat Remote Hubs.!
4. Click “Apps”, “Add User App”.!
5. Select “HubConnect Remote Client”.!
6. Hit “Done” when the screen updates.!
7. Repeat this process for all Hubitat remote hubs.!
SmartThings Remote Hub; perform the following pre-installation steps:!
1. Install the SmartThings Remote Client app by importing the file “SmartThings/
HubConnect-Remote-Client.groovy”.!
2. (optional) For large systems it may be advisable to pre-install all of the drivers located in
“UniversalDrivers/HubConnect-*.groovy”. For most environments, this step can be deferred
for now. HubConnect will advise as to which drivers are needed at the time of device
selection.!
3. Go to “Marketplace”, scroll to the bottom and tap on “My Apps”.!
4. Select “HubConnect Remote Client”.!
5. Hit “Done” when the screen updates.!
6. Repeat this process for all SmartThings Remote Hubs.!
Once HubConnect Remote Client has been installed on all of the satellite hubs, move on to
connecting them to the Server Hub.!
Connecting a Hub:!
1. On the Master hub, go to the HubConnect Server for Hubitat app.!
2. Click “Connect a Hub"!
3. At the Main Menu, Click "Connect to Client Hub"!
1. Enter a Friendly Name for the hub.!
2. Enter the local LAN IP of the remote Hub (even if the hub is not on the same LAN or in
the same location)!
3. Choose the Type of Remote Hub (SmartThings or Hubitat).!
4. Copy the Connection Key shown in the text box.!
4. Switch over to the Hubitat web UI (or SmartThings app) for the Remote Hub.!
5. Go to the HubConnect Remote Client app.!
6. Click "Connect to Server Hub".!
1. Enter the local LAN IP of the Server Hub (even if the hub is not on the same LAN or in
the same location)!
2. Paste the Server Hub’s Connection Key from step 3.4 above in to the “Paste the server
hub's connection key here:” box.!
3. The UI should update to show a “Connected!” status if successful.!
4. Click Done if status shows connected or re-paste the Connection Key if not.!
7. Select devices on the Remote Hub to connect to the Server hub.!
1. If the drivers were not previously installed, make sure all of the recommended device
drivers are installed on the Server Hub prior to clicking “Done”.!
8. Select devices on the Server hub to connect to the Remote hub.!
1. If the drivers were not previously installed, make sure all of the recommended device
drivers are installed on the Remote Hub prior to clicking “Done”.!
9. Enjoy using HubConnect!!
