====== KeexyBox - Network settings ======

You will need a minimum of technical knowledge of TCP/IP to setup the network and you must understand the different [[network_topologies|network topologies of KeexyBox]].

:!: KeexyBox does not currently support IPv6. We are working on it.

To setup the network:
  - Use your browser and connect to the [[using_admin_access|KeexyBox Management Web interface]].
  - On left menu, go to ''System settings -> Network''.
  - You will be redirected to the ''Network settings'' page.
  - Complete the form as explained below.
  - When you are done, click on ''Save'' to save settings otherwise click on ''Cancel''. You will need to [[diagnostics_services_power#Power management|reboot]] KeexyBox for the configuration to take effect.

===== Input network =====
The input network is where the users and devices are located. The IP configuration you set here will be used as DNS and Gateway if devices are in the [[network_topologies#use_keexybox_for_website_filtering_and_anonymity|website filtering and anonymity topology]] or in the [[network_topologies#mixed_use_of_keexybox|mixed use topology]].

^Field^Description^
|**Interface**|Select the physical interface to use for the IP configuration. You can use the same interface as output network if you want. If the interface you select appears to be a Wifi interface, a button will be displayed and you have to click on it to define [[#wifi_settings|Wifi settings]].|
|**IP address**|The IP address you set here will be use as the gateway and the DNS for your devices.|
|**Netmask**|Here define the network mask of the ''IP address''.|

:!: The Input network configuration will not be used if you use KeexyBox for [[network_topologies#use_keexybox_for_website_filtering_only|website filtering only]], but you need to leave the IP configuration that is already set or set an IP configuration in a network you will not use.


===== Output network =====
The output network is where your internet router is located. The IP configuration you set here will be used to communicate with your Internet router. It can also be used as DNS for devices that are in the [[network_topologies#use_keexybox_for_website_filtering_only|website filtering only topology]] or in the [[network_topologies#mixed_use_of_keexybox|mixed use topology]].

^Field^Description^
|**Interface**|Select the physical interface to use for the IP configuration. You can use the same interface as input network if you want. If the interface you select appears to be a Wifi interface, a button will be displayed and you have to click on it to define [[#wifi_settings|Wifi settings]].|
|**IP address**|The address IP you set here will be use as the DNS for your devices.|
|**Netmask**|Here define the network mask of the ''IP address''.|

===== DNS and Gateway =====

^Field^Description^
|**Gateway**|Here you have to enter the IP address of your Internet router.|
|**DNS 1**|Here you have to enter IP addresses of DNS server you want to use to relay DNS queries to the Internet. You have the option of not relaying DNS queries on these DNS by unchecking the box ''Use defined DNS as redirectors'' on the [[system_settings_misc#domains_routing_and_dns_options|Miscellaneous settings]] page.|
|**DNS 2**|Enter a second DNS server in case the first does not work.|
    

===== Wifi settings =====

If you have chosen a WiFi interface for the network configuration, you will see a ''Wifi settings'' button below the selected interface. You will have to click on it to open a page that allows you to setup or verify the Wifi configuration (WPA Supplicant). On this page, modify the text area to change the content of ''/etc/wpa_supplicant/wpa_supplicant.conf'' file.

Below an example of a configuration for France:

  country=FR
  ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
  update_config=1
  
  network={
      ssid="MY_WIFI_SSID"
      psk="MyWifiPassword"
  }