Testing DHCP Server

Contents:

Test setup with Virtual Box
Quick test with DHCPTest

<a href="#vbox" id="vbox" name="vbox">Test setup with Virtual Box</a>

Prerequisites

To set up a test environment for DHCP server you will need:

Linux AG Home host machine (Virtual)
Virtual Box
Virtual machine (guest OS doesn't matter)

Configure Virtual Box

Install Virtual Box and run the following command to create a Host-Only network:
sh
```
VBoxManage hostonlyif create
```
You can check its status by ip a command.

You can also set up Host-Only network using Virtual Box menu in File → Host Network Manager.
Create your virtual machine and set up its network in VM Settings → Network → Host-only Adapter.
Start your VM, install an OS. Configure your network interface to use DHCP and the OS should ask for a IP address from our DHCP server.
To see the current IP addresses on client OS you can use ip a command on Linux or ipconfig on Windows.
To force the client OS to request an IP from DHCP server again, you can use dhclient on Linux or ipconfig /release on Windows.

Configure server

Edit server configuration file AdGuardHome.yaml, for example:

yaml

dhcp:
    enabled: true
    interface_name: vboxnet0
    local_domain_name: lan
    dhcpv4:
        gateway_ip: 192.168.56.1
        subnet_mask: 255.255.255.0
        range_start: 192.168.56.2
        range_end: 192.168.56.2
        lease_duration: 86400
        icmp_timeout_msec: 1000
        options: []
    dhcpv6:
        range_start: 2001::1
        lease_duration: 86400
        ra_slaac_only: false
        ra_allow_slaac: false

Start the server:
sh
```
./AdGuardHome -v
```
There should be a message in log which shows that DHCP server is ready:
none
```
[info] dhcpv4: listening
```

<a href="#dhcptest" id="dhcptest" name="dhcptest">Quick test with DHCPTest utility</a>

Prerequisites

DHCP test utility.

Quick test

The DHCP server could be tested for DISCOVER-OFFER packets with in interactive mode.