Difference between revisions of "Network Setup"

From Hubitat Documentation
Jump to: navigation, search
(WiFi Adapter setup)
Line 1: Line 1:
{{Top}}
+
{{Top}}<big>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.</big>
  
<big>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.</big>
+
<big>'''NOTE:'''</big>
 
 
'''<big>NOTE:</big>'''
 
  
 
*<big>WiFi dongles are '''not included''' with Hubitat Elevation. For maximum reliability, connect Hubitat Elevation to your network with an Ethernet cable whenever possible.</big>
 
*<big>WiFi dongles are '''not included''' with Hubitat Elevation. For maximum reliability, connect Hubitat Elevation to your network with an Ethernet cable whenever possible.</big>
Line 10: Line 8:
  
 
===<big>Static IP/DHCP configuration</big>===
 
===<big>Static IP/DHCP configuration</big>===
 
 
====<big>Static IP address</big>====
 
====<big>Static IP address</big>====
  
#<big>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.</big>[[File:Static IP address entry.jpg|none|thumb|614x614px|link=https://docs.hubitat.com/images/d/d8/Static_IP_address_entry.jpg
+
#<big>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.</big>[[File:Static IP address entry.jpg|none|thumb|614x614px]]
]]
+
#<big>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).</big>[[File:Static IP values entered.jpg|none|thumb|604x604px]]
#<big>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).</big>[[File:Static IP values entered.jpg|none|thumb|604x604px|link=https://docs.hubitat.com/images/e/eb/Static_IP_values_entered.jpg
+
#<big>'''You must [https://docs.hubitat.com/Settings reboot] the Hub for the setting to take effect.'''</big>[[File:Reboot after changing static-DHCP.jpg|none|thumb|628x628px]]
]]
 
#'''<big>You must [[Settings|Reboot]] the Hub for the setting to take effect.</big>'''[[File:Reboot after changing static-DHCP.jpg|none|thumb|628x628px|link=https://docs.hubitat.com/images/f/f1/Reboot_after_changing_static-DHCP.jpg
 
]]
 
  
 
====<big>DCHP address</big>====
 
====<big>DCHP address</big>====
  
#<big>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 [[Settings|reboot]] the hub.</big>
+
#<big>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 [https://docs.hubitat.com/Settings reboot] the hub.</big>
#*<big>'''NOTE''': Any time you switch between '''Static IP''' and '''DHCP''', you must [[Settings|reboot]] the hub or the setting will not take effect.</big>[[File:Switch back to DHCP.jpg|none|thumb|600x600px|link=https://docs.hubitat.com/images/a/a4/Switch_back_to_DHCP.jpg
+
#*<big>'''NOTE''': Any time you switch between '''Static IP''' and '''DHCP''', you must [https://docs.hubitat.com/Settings reboot] the hub or the setting will not take effect.</big>[[File:Switch back to DHCP.jpg|none|thumb|600x600px]]
]]
+
#<big>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'''.</big>[[File:Hub DHCP reset button.png|none|thumb|254x254px]]
#<big>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'''.</big>[[File:Hub DHCP reset button.png|none|thumb|255x255px|link=https://docs.hubitat.com/images/1/16/Hub_DHCP_reset_button.png
 
]]
 
 
#*
 
#*
 +
 +
===<big>Cellular Adapter setup</big>===
 +
 +
#<big>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.</big>[[File:OTG + power cable.png|none|thumb|346x346px]]
 +
#<big>Press the '''Add adapter support''' button to install support for the cellular adapter.</big>
 +
#*<big>'''NOTE:''' No additional drivers are required for cellular adapters.</big>
 +
#*<big>Wait for the confirmation, '''Cellular adapter support added''' before plugging in the adapter.</big>[[File:Add Cellular adapter support v3.png|none|thumb|600x600px]]
 +
#<big>Plug in the cellular adapter and '''[https://docs.hubitat.com/Settings reboot]''' the hub.</big>
 +
#*<big>'''NOTE:''' You must '''[https://docs.hubitat.com/Settings reboot]''' the hub before the cellular adapter will allow Remote Admin to access the hub over a cellular network.</big>
 +
#*<big>The USB cellular modem is intended to be used with a [https://docs.hubitat.com/Remote_Admin Remote Admin] subscription to manage a hub in a remote location without WiFi.</big>[[File:Cellular adapter support added v2.png|none|thumb|600x600px]]
  
 
===<big>WiFi Adapter setup</big>===
 
===<big>WiFi Adapter setup</big>===
  
#<big>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.</big>[[File:OTG + power cable.png|none|thumb|347x347px|link=https://docs.hubitat.com/images/6/66/OTG_%2B_power_cable.png
+
#<big>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.</big>[[File:OTG + power cable.png|none|thumb|346x346px]]
]]
+
#<big>Press the Install WiFI driver button and ensure the installation succeeded before continuing.</big>[[File:WiFi adapter setup.png|none|thumb|600x600px]]
#<big>Press the Install WiFI driver button and ensure the installation succeeded before continuing.</big>[[File:WiFi adapter setup.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/4/4c/WiFi_adapter_setup.png
 
]]
 
 
#<big>Enter the network name (SSID) of the WiFi network you want your hub to join and then enter the WiFi password.</big>
 
#<big>Enter the network name (SSID) of the WiFi network you want your hub to join and then enter the WiFi password.</big>
#<big>Press the '''Save WiFi configuration''' button and [[Settings|'''reboot''']] the hub.</big>
+
#<big>Press the '''Save WiFi configuration''' button and '''[https://docs.hubitat.com/Settings reboot]''' the hub.</big>
#*<big>'''NOTE:''' You must [[Settings|'''reboot''']] the hub to activate your WiFi adapter and connect it to your WiFi network.</big>[[File:Enter WiFi username and password.jpg|none|thumb|644x644px|link=https://docs.hubitat.com/images/0/0f/Enter_WiFi_username_and_password.jpg]]
+
#*<big>'''NOTE:''' You must '''[https://docs.hubitat.com/Settings reboot]''' the hub to activate your WiFi adapter and connect it to your WiFi network.</big>[[File:Enter WiFi username and password.jpg|none|thumb|644x644px]]
  
'''<span style="color: red;;"><big>IMPORTANT !</big></span>'''
+
<big>'''<span style="color: red;;">IMPORTANT !</span>'''</big>
  
*<big>You must [[Settings|reboot]] the hub or the setting will not take effect.</big>
+
*<big>You must [https://docs.hubitat.com/Settings reboot] the hub or the setting will not take effect.</big>
 
*<big>WiFi dongles are '''not included''' with Hubitat Elevation. For maximum reliability, connect the hub to your network with an Ethernet cable whenever possible.</big>
 
*<big>WiFi dongles are '''not included''' with Hubitat Elevation. For maximum reliability, connect the hub to your network with an Ethernet cable whenever possible.</big>
 
*<big>'''Static IP/DHCP''' configuration is for use with the built in Ethernet port only. '''WiFi USB adapters always use DHCP'''.</big>
 
*<big>'''Static IP/DHCP''' configuration is for use with the built in Ethernet port only. '''WiFi USB adapters always use DHCP'''.</big>
*<big>'''WiFi USB adapter''' configuration is not available for hubs prior to '''Model C-7'''.</big>
+
*<big>'''WiFi USB adapter''' configuration is not available for hubs prior to '''Model C-5'''.</big>
  
 
===<big>Changing connection from WiFi to Ethernet</big>===
 
===<big>Changing connection from WiFi to Ethernet</big>===
 
<big>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.</big>
 
<big>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.</big>
  
#<big>[[Settings|'''Shutdown''']] the hub.</big>
+
#<big>'''[https://docs.hubitat.com/Settings Shutdown]''' the hub.</big>
 
#<big>Disconnect your WiFi adapter (and the special OTG + power cable if desired).</big>
 
#<big>Disconnect your WiFi adapter (and the special OTG + power cable if desired).</big>
 
#<big>Plug in an Ethernet cable, connecting the hub to your router or network switch.</big>
 
#<big>Plug in an Ethernet cable, connecting the hub to your router or network switch.</big>
 
#<big>Unplug your hub from its power source for a '''minimum of 30 seconds''' before plugging it back in.</big>
 
#<big>Unplug your hub from its power source for a '''minimum of 30 seconds''' before plugging it back in.</big>
 
#*<big>'''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.</big>
 
#*<big>'''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.</big>
 
 
__NOINDEX__
 
__NOINDEX__

Revision as of 22:59, 24 March 2021

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.