# EasyPXE-DNSMasq

EasyPXE-DNSMasq is a dnsmasq container that adds proxyDHCP and TFTP to the EasyPXE PXE boot stack, supplying PXE boot information to UEFI and Legacy BIOS clients without replacing your router's DHCP server. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/811/easypxe-dnsmasq

## Description

EasyPXE-DNSMasq is a dnsmasq container that adds proxyDHCP and TFTP to the EasyPXE PXE boot stack, supplying PXE boot information to UEFI and Legacy BIOS clients without replacing your router's DHCP server.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 65 (last commit 129 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/4km3/dnsmasq
- GitHub: https://github.com/OKiU-Network-Europe/EasyPXE-Unraid
- Unraid: https://ca.unraid.net/apps/easypxe-dnsmasq-0gxj6u00a9jdos?q=EasyPXE-DNSMasq

## Common questions

### Does EasyPXE-DNSMasq replace my router’s DHCP server?

No, it runs dnsmasq in proxyDHCP mode so clients still get their IP address from the existing router. It only adds PXE boot information, and no router changes are needed.

### Which ports are used by the EasyPXE stack?

TFTP runs on UDP 69 for the bootloader, and the HTTP menu runs on port 8080 by default. Set HTTP_PORT in the .env file if you need a different HTTP port because Unraid uses port 80 for its UI.

### Where should I put ISO files for the boot menu?

Put them in /mnt/user/isos by default, because docker-compose bind-mounts that share as /isos on the HTTP server. If your ISO share is in another path, edit the volume line in docker-compose.yml.

### Can I change boot menus without restarting the container?

Yes, edit http/menus/local.ipxe and the changes take effect immediately. The stack fetches the menu fresh on every boot, so no container restart is needed for menu changes.

### How can I confirm the PXE services are responding?

From another LAN machine, retrieve undionly.kpxe with TFTP and request the boot.ipxe file from the HTTP server. You can also watch the dnsmasq container logs with docker logs -f pxe-dnsmasq.

---
Source: Our Local Host (https://ourlocalhost.com/app/811/easypxe-dnsmasq), the self-hosted and open-source app directory.