Installing the HubConnect Server

Installing the HubConnect proxy server is a very simple process and can run on virtually any hardware due to its small footprint.

System Requirements

  • A Mac, Windows. or Linux operating environment.  (i.e. Raspberry Pi)
  • Node version 11 (recommended), versions 8+ should work.

Installing the HubConnect Server

  1. Create a directory on your server or Raspberry Pi for the HubConnect proxy server:

    mkdir hubconnect

  2. Copy the following files to the directory created in step 1:
    1. proxy.js
    2. config.json
    3. package.json
  3. Edit the config.json file for your Hubitat environment. An explanation of the file can be found here and a tool for generating configuration files is also available here.
  4. Install the server.  In the directory which the files were copied into in step 2, run the following command:

    npm install -g

  5. Start the server:

    node proxy.js

  6. Log into the server hub, open each connected hub, click Connect to Remote Hub, then Disconnect.  (No devices will be lost)
  7. Re-configure the remote hub connection that was disconnected in step 6, selecting the Use Proxy toggle, then filling in the connection information from step 3.
  8. Check the Remote Hub device on the server hub to confirm that the hub connected to the proxy.
  9. Log in to each remote hub to verify that each Remote Hub device has connected to the proxy.

That's it!  Please open a support ticket for assistance.

  • v2beta
  • 1 Users Found This Useful
Was this answer helpful?

Related Articles

Understanding the Server Config (config.json) File

The HubConnect server is configured using a very simple config.json file which tells the server...