KeexyBox - DHCP settings

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

To configure DHCP before version 21.04.1, 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 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 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 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 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 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 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 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.

About KeexyBox Project:

KeexyBox's wiki

Table of Contents