====== KeexyBox - DHCP settings ======

:!: **This article describes the DHCP configuration of KeexyBox from version 21.04.1.** :!:

To configure DHCP before version 21.04.1, [[system_settings_dhcp_20.10.2|see this article]].

The DHCP allows you to dynamically assign an IP address and other network settings to each device on your network. For a better use of KeexyBox, it is recommended to enable it on KeexyBox and to disable it on your Internet router.



===== Using KeexyBox DHCP =====

Using KeexyBox's DHCP offers the following advantages:
  * It will assign an IP address which ease the connection to the [[https://www.torproject.org/|Tor]] anonymity network.
  * It will assign directly the right DNS configuration for domain/website filtering.
  * It will ease to reserve IP address by detecting devices on your network.
==== Disable DHCP on your Internet Router ====

Before enabling KeexyBox's DHCP, you must disable the DHCP on your Internet router to avoid conflict. We can't explain how to do it here because it depends on the router model you have. You should refer to the documentation of your router or request technical assistance from your Internet service provider.

==== Edit settings and enable DHCP on KeexyBox ====

  - Use your browser and connect to the [[using_admin_access|KeexyBox Management Web interface]].
  - On left menu, go to ''System settings -> DHCP''.
  - You will be redirected to the ''DHCP settings'' page.
  - Complete the form as explained below.
  - When you are done, click on ''Save'' to save settings otherwise click on ''Cancel''..

Description of DHCP settings:

^Field^Description^
|**Enable DHCP** (input network)|Check this box to enable DHCP on the input network. //Note: If the input network and output network share the same physical interface, checking this box will automatically enable DHCP on the output network.//|
|**Enable DHCP** (output network)|Check this box to enable DHCP on the output network. //Note: If the input network and output network share the same physical interface, unchecking this box will automatically disable DHCP on the output network.//|
|**Address range for the network: ''(input network)''**|Here define the ''DHCP start IP'' and ''DHCP end IP'' for the input network. If the box decribed above is unchecked, DHCP will work by default on the input network. Conversely, if the box decribed above is checked, DHCP will be disabled for the input network.|
|**Address range for the network: ''(output network)''**|Here define the ''DHCP start IP'' and ''DHCP end IP'' for the output network. If the box decribed above is checked, DHCP will work by default on the output network. Conversely, if the box decribed above is unchecked, DHCP will only work for devices that have a DHCP reservation on the output network.|

Click on ''Save'' to save settings and automatically start or restart DHCP service.



==== DHCP reservation ====

DHCP IP reservation allows you to always assign the same IP address to a device.

Depending on the [[network_topologies|network topology]] you have chosen for your KeexyBox, you can reserve IP addresses to your devices in the input or output network. If you have opted for [[network_topologies#mixed_use_of_keexybox|KeexyBox as mixed use topology]], you will need to reserve IP addresses in the output network to allow your devices such as television or TV decoder to receive braodcast streams that KeexyBox may not able to relay.

To reserve IP addresses for your devices, refer to [[devices_manage|Manage devices]] page.


===== I do not want to use KeexyBox's DHCP =====

If you do not want to use the KeexyBox's DHCP:
  * You will need to manually setup the IP configuration of your devices which you want to connect to the [[https://www.torproject.org/|Tor]] anonymity network.
  * You will need to change the DHCP settings on your Internet router to change the DNS that it assigns to your devices.

==== Change DNS configuration in the DHCP settings of your Internet Router ====

You must change the DNS address on DHCP settings of your Internet router. You have to define as DNS, the KeexyBox's IP address set for ouput network. We can't explain how to do it here because it depends on the router model you have. You should refer to the documentation of your router or request technical assistance from your Internet service provider.

You can get the IP address to set as DNS as follow:

  - 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.
  - On the ''Output network'' section copy the ''IP address''.