wastrachan/dhcpd repository overview

⁠ARCHIVE NOTICE: ISC DHCPD reached end of life⁠ in 2022. As such, this image will receive no further updates or builds. ISC officially recommends you migrate to Kea⁠.

⁠Docker DHCPD

ISC DHCP Server in a Docker container, with configuration files in a volume, and a configurable UID/GID for said files.

⁠Install

⁠Docker Hub

Pull the latest image from Docker Hub:

docker pull wastrachan/dhcpd

⁠Manually

Clone this repository, and run make build to build an image:

git clone https://github.com/wastrachan/docker-dhcpd.git
cd docker-dhcpd
make build

If you need to rebuild the image, run make clean build.

⁠Run

⁠Docker

Run this image with the make run shortcut, or manually with docker run.

docker run -v "$(pwd)/config:/config" \
           --name docker-dhcpd \
           -e PUID=1111 \
           -e PGID=1112 \
           -p 67:67/udp \
           --restart unless-stopped \
           wastrachan/dhcpd:latest

⁠Docker Compose

If you wish to run this image with docker-compose, an example docker-compose.yml might read as follows:

---
version: "2"

services:
  docker-dhcpd:
    image: wastrachan/dhcpd
    container_name: docker-dhcpd
    environment:
      - PUID=1111
      - PGID=1112
    volumes:
      - </path/to/config>:/config
    ports:
      - 67:67/udp
    restart: unless-stopped

⁠Configuration

Configuration files are stored in the /config volume. You may wish to mount this volume as a local directory, as shown in the examples above.

⁠User / Group Identifiers

If you'd like to override the UID and GID of the application, you can do so with the environment variables PUID and PGID. This is helpful if other containers must access your configuration volume.

⁠Services

⁠Volumes

⁠License

The content of this project itself is licensed under the MIT License⁠.

View license information⁠ for the software contained in this image.