Network Setup

From Hubitat Documentation
Revision as of 23:30, 24 March 2021 by Doug (talk | contribs)
Jump to: navigation, search
Go to the top of the page

The Networking settings allow you to switch between DHCP (Dynamic Host Configuration Protocol) for automatic setting of your hub IP address, or Static IP where you can define the IP address for your hub when connected by Ethernet cable. You can also add a compatible WiFi dongle to allow your hub to join a WiFi network without the need to attach an Ethernet cable.

NOTE:

  • WiFi dongles are not included with Hubitat Elevation. For maximum reliability, connect Hubitat Elevation to your network with an Ethernet cable whenever possible.
  • Static IP/DHCP configuration is for use with the built-in Ethernet port only. WiFi USB adapters will always use DHCP.
  • Setting a Static IP address and configuring a WiFi USB adapter is not available for hubs prior to Model C-5.

Static IP/DHCP configuration

Static IP address

  1. Enter the desired non-routable IP address for your hub to use. The first three octets must match the other devices on your network, but the fourth octet can be any available number on your network. Use the Command shell tool on Windows (Type cmd into Windows search), or the Terminal app on MacOS (Located in the Applications > Utilities folder) to ping the IP address you wish to use, ensuring that there is no response from another device on your network before setting your hub to that IP address.
    Static IP address entry.jpg
  2. Press Save and switch to static IP. Ensure the first three octets are the same for the IP address and Default gateway in accordance with your router IP address settings (i.e. 192.168.0.x).
    Static IP values entered.jpg
  3. You must reboot the Hub for the setting to take effect.
    Reboot after changing static-DHCP.jpg

DCHP address

  1. To change back to DHCP and let the router assign an IP address to your hub via its MAC Address, press the Switch to DHCP now button and reboot the hub.
    • NOTE: Any time you switch between Static IP and DHCP, you must reboot the hub or the setting will not take effect.
      Switch back to DHCP.jpg
  2. If you are accidentally blocked from accessing your hub due to an incorrect or unknown IP address setting, turn the hub over and use the point of a pen to press the small button just beneath the surface of the hub casing for at least 7 seconds.
    Hub DHCP reset button.png

Cellular Adapter setup

  1. Connecting a USB device to your Hubitat hub requires a special OTG + power cable. This type of adapter cable feeds power to the hub while simultaneously providing a USB data connection for USB devices.
    OTG + power cable.png
  2. Press the Add adapter support button to install support for the cellular adapter.
    • NOTE: No additional drivers are required for cellular adapters.
    • Wait for the confirmation, Cellular adapter support added before plugging in the adapter.
      Add Cellular adapter support v3.png
  3. Plug in the cellular adapter and reboot the hub.
    • NOTE: You must reboot the hub before the cellular adapter will allow Remote Admin to access the hub over a cellular network.
    • The USB cellular modem is intended to be used with a Remote Admin subscription to manage a hub in a remote location without WiFi.
      Cellular adapter support added v2.png

WiFi Adapter setup

  1. Follow the instructions to add a compatible WiFi adapter to your hub. Connecting a USB device to your Hubitat hub requires a special OTG + power cable. This type of adapter cable feeds power to the hub while simultaneously providing a USB data connection for USB devices.
    OTG + power cable.png
  2. Press the Install WiFI driver button and ensure the installation succeeded before continuing.
    WiFi adapter setup.png
  3. Enter the network name (SSID) of the WiFi network you want your hub to join and then enter the WiFi password.
  4. Press the Save WiFi configuration button and reboot the hub.
    • NOTE: You must reboot the hub to activate your WiFi adapter and connect it to your WiFi network.
      Enter WiFi username and password.jpg

IMPORTANT !

  • You must reboot the hub or the setting will not take effect.
  • WiFi dongles are not included with Hubitat Elevation. For maximum reliability, connect the hub to your network with an Ethernet cable whenever possible.
  • Static IP/DHCP configuration is for use with the built in Ethernet port only. WiFi USB adapters always use DHCP.
  • WiFi USB adapter configuration is not available for hubs prior to Model C-5.

Changing connection from WiFi to Ethernet

If you have configured a WiFi adapter and want to restore hub connection via Ethernet, do not simply pull the WiFi adapter from your hub.

  1. Shutdown the hub.
  2. Disconnect your WiFi adapter (and the special OTG + power cable if desired).
  3. Plug in an Ethernet cable, connecting the hub to your router or network switch.
  4. Unplug your hub from its power source for a minimum of 30 seconds before plugging it back in.
    • NOTE: To avoid stressing the micro USB connection, it is recommended that power be removed from the hub by unplugging the power adapter from the outlet instead of the hub.