====== Configure the Hotspot ======
===== Connect to Web interface =====
<note important>**DO NOT CLICK on RESET FACTORY button** as it will remove the Helium miner software from your Hotspot. \\ The feature is reserved to technical Support Team</note>

++++The easiest way to connect to your hotspot is to address it by name.| 
Wirnet gateways are named after their serial number, as described below, with XXXXXX replaced by the last six hexadecimal digits from the board ID.

^ Hotspot model                   ^ URL template                ^
| **Wirnet iStation**             | ''http://klk-wiis-XXXXXX.local '' |
| **Wirnet iFemtoCell**           | ''http://klk-wifc-XXXXXX.local '' |
| **Wirnet iFemtoCell-evolution** | ''http://klk-fevo-XXXXXX.local '' |

For the Wirnet iFemtoCell with 704BEc1234AB as board ID, the hostname will be: **klk-wifc-1234AB**. 

It is also possible to enter the IP address of your hotspot into your browser’s URL bar (Make sure your computer is on the same local network).\\

The default credentials are:\\
Login:''admin''\\
Password:''pwd4admin''\\
It's very recommended to change them.\\

{{:images:WI_overview.png?1000|}}
++++
++++ Using local connection through USB-C for iStation and iFemtoCell-evolution only.|
You can connect a PC directly to the iStation and iFemtoCell-evolution with a USB cable. In this mode, the hotspot will simulate an ethernet device. 
  * In nominal case, after few seconds, your PC will obtain an IP address and you will be able to start a SSH client or HTTP connection on hotspot IP 192.168.120.1.
  * In particular case you are using a DHCP server on your computer, hotspot will directly obtain an IP address. A connection can then be done on this IP address.
{{images:usb-c_connection.png?600}} ++++

===== Network setup =====
The network can be easily configured thanks to the web interface.

++++ Ethernet (default) |
Simplest and preferred. Available on all Kerlink hotspots\\

= >  Plug the hotspot to the WAN access point with an Ethernet cable. The connection will be established automatically.\\
\\
  * You can enabled/disabled the Ethernet connection but be careful of the consequences of disabling
<note warning>
  * If you turn OFF IPv4 configuration, you are disconnected from the web interface and Ethernet is fully disabled!
  * **Using iFemtoCell, you will not be able to connect to the web interface later.**
</note>
  * You can configure your IPV4 connection:
    * DHCP.
    * Manual: Use a static IP.
    * OFF: Will turn OFF the IPv4 configuration.

{{:images:wi_network_ethernet.png?1000|}}
++++

++++ Cellular (except Wirnet iFemtoCell)|
<note important>If you are using cellular connection, your hotspot will stay in relayed mode.\\
Please see [[#4.3 Network configuration|4.3 Network configuration]]</note>
The cellular access can be configured in the web interface.\\
Cellular connection requires an USIM and a data subscription (not included)\\

  * Insert SIM 
  * If it does not work out of the box, you may need to configure APN of the SIM card on the web interface 
  * If so, enter the MCC/MNC corresponding to your network operator

{{:images:wi_network_GSM.png?1000|}}

<note important>
  * If a Roaming SIM card is inserted in the hotspot, the **MCC/MNC** codes to configure should be those ones of the SIM and not those of the local operator.
  * The **APN** to configure is the one of the SIM provider also, not the one of the local operator.
</note>
**To test if the configuration is the good one, please just unplugg Ethernet cable and wait for some minutes, the backhaul should automaticaly switch to cellular connection.**
You may use the onboarding dashboard to check connectivity after 15-30 minutes.
++++

++++ WiFi (Wirnet iFemtoCell only) |
  * If you have a WPS-compatible (Wi-Fi Protected Setup) Wi-Fi Access Point, press the WPS button on the Wirnet iFemtoCell and then press the WPS button on the Wi-Fi Access Point of the installation. The connection will be established automatically.
  * Without WPS-compatible Wi-Fi Access point, Wi-Fi connection can be done either through Wired Ethernet or through the __Wi-Fi AP that is enabled for one hour after reboot__:
    * Choose your Wi-Fi access point in the list.
    * Click on the access point name:
       * For passphrase-protected WiFi, fill the passphrase in the newly opened window and click “Connect”.
       * For WPS-enabled Access Point, or if your WiFi AP is open, just click “Connect”.
    * The Wi-Fi network will appear connected in front of the network name.

{{:images:WI_wifi_wifc_only.png?1000|}}

<note important>If this feature is enabled or disabled, don't forget to save the modification.</note>
++++

The Full Miner communicates over a peer-to-peer (P2P) network and needs to connect to the remote port 44158. \\
**The Light Hotspot → Validator connection is a standard gRPC connection. The default port Validators listen on is 8080 so Hotspots should be able to connect Outbound to that port.** \\
Hence, other miners must have this port forwarded to their miner IP address, and so should you. Indeed, other miners will want to connect to your miner too. \\
More info on port forwarding can be found on Helium documentation:\\
  * [[https://docs.helium.com/troubleshooting/understanding-witnesses/#relayed-hotspots-and-the-importance-of-opening-ports|Why open ports? ]]
  * [[https://docs.helium.com/troubleshooting/network-troubleshooting/|Network troubleshooting ]]

<note important>Do not expose/port forward the TCP port 80 from the outside. </note>