User Tools

Site Tools


system_settings_network

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 of KeexyBox.

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

To setup the network:

  1. Use your browser and connect to the KeexyBox Management Web interface.
  2. On left menu, go to System settings → Network.
  3. You will be redirected to the Network settings page.
  4. Complete the form as explained below.
  5. When you are done, click on Save to save settings otherwise click on Cancel. You will need to 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 website filtering and anonymity topology or in the mixed use topology.

FieldDescription
InterfaceSelect 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.
IP addressThe IP address you set here will be use as the gateway and the DNS for your devices.
NetmaskHere define the network mask of the IP address.

:!: The Input network configuration will not be used if you use KeexyBox for 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 website filtering only topology or in the mixed use topology.

FieldDescription
InterfaceSelect 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.
IP addressThe address IP you set here will be use as the DNS for your devices.
NetmaskHere define the network mask of the IP address.

DNS and Gateway

FieldDescription
GatewayHere you have to enter the IP address of your Internet router.
DNS 1Here 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 Miscellaneous settings page.
DNS 2Enter 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"
}

About KeexyBox Project:

system_settings_network.txt · Last modified: 2020/09/25 09:34 by paul