Skip to content

homecentr/docker-dhcp

Repository files navigation

Project status

CI/CD on master Regular Docker image vulnerability scan

HomeCentr - ISC DHCP Server

Usage

Please see the docker-compose.yml

Exposed ports

Port Protocol Description
67 UDP DHCP Server

⚠️ Due to the nature of the DHCP protocol which is highly dependent on broadcast, exposing the container via a bridge network will not work as explained below. Because of this, the container should be exposed via drivers which allow the container to expose the port directly (host, macvlan, ipvlan).

Docker daemon will not pass the broadcast packets to the container because the container internally has an IP specific to the bridge network (e.g. 172.16.10.1) but the broadcast packet will be sent with the IP of your host machine (e.g. 192.168.2.50). The bridge will therefore decide the broadcast packet was not meant for the container and will not forward it.

Volumes

Container path Description
/config Configuration directory which must contain the dhcpd.conf file. See the official documentation on how to configure the DHCP server.
/leases This is where the DHCP server records which IP addresses have been leased to individual clients. The location must be writable by the PUID/PGID.

Security

The container is regularly scanned for vulnerabilities and updated. Further info can be found in the Security tab.

Container user

The container uses UID:GID of 1000:1000 by default. Image must be rebuilt in case you need to use a different UID or GID due to file permissions.