README.md

dnsmasq

dnsmasq provides a container image for running DHCP, proxy DHCP, DNS, and/or TFTP with dnsmasq. Use it to test different network setups with clusters of network bootable machines.

The image bundles undionly.kpxe which chainloads PXE clients to iPXE and grub.efi (experimental) which chainloads UEFI architectures to GRUB2.

Usage

Run the container image as a DHCP, DNS, and TFTP service.

sudo rkt run --net=host quay.io/coreos/dnsmasq \
  --caps-retain=CAP_NET_ADMIN,CAP_NET_BIND_SERVICE,CAP_SETGID,CAP_SETUID,CAP_NET_RAW \
  -- -d -q \
  --dhcp-range=192.168.1.3,192.168.1.254 \
  --enable-tftp \
  --tftp-root=/var/lib/tftpboot \
  --dhcp-userclass=set:ipxe,iPXE \
  --dhcp-boot=tag:#ipxe,undionly.kpxe \
  --dhcp-boot=tag:ipxe,http://matchbox.example.com:8080/boot.ipxe \
  --address=/matchbox.example.com/192.168.1.2 \
  --log-queries \
  --log-dhcp

sudo docker run --rm --cap-add=NET_ADMIN --net=host quay.io/coreos/dnsmasq \
  -d -q \
  --dhcp-range=192.168.1.3,192.168.1.254 \
  --enable-tftp --tftp-root=/var/lib/tftpboot \
  --dhcp-userclass=set:ipxe,iPXE \
  --dhcp-boot=tag:#ipxe,undionly.kpxe \
  --dhcp-boot=tag:ipxe,http://matchbox.example.com:8080/boot.ipxe \
  --address=/matchbox.example/192.168.1.2 \
  --log-queries \
  --log-dhcp

Press ^] three times to stop the rkt pod. Press ctrl-C to stop the Docker container.

Configuration Flags

Configuration arguments can be provided as flags. Check the dnsmasq man pages for a complete list.

flag	description	example
--dhcp-range	Enable DHCP, lease given range	172.18.0.50,172.18.0.99, 192.168.1.1,proxy,255.255.255.0
--dhcp-boot	DHCP next server option	http://matchbox.foo:8080/boot.ipxe
--enable-tftp	Enable serving from tftp-root over TFTP	NA
--address	IP address for a domain name	/matchbox.foo/172.18.0.2

Development

Build a container image locally.

make docker-image

Run the image with Docker on the docker0 bridge (default).

sudo docker run --rm --cap-add=NET_ADMIN coreos/dnsmasq -d -q