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

Pull the latest image from Docker Hub:

docker pull wastrachan/dhcpd

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 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

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 files are stored in the /config volume. You may wish to mount this volume as a local directory, as shown in the examples above.

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.

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

View license information for the software contained in this image.