# DHCP-Netboot

DHCP-Netboot is a self-hosted network services app. This Docker container lets you PXE boot a bunch of installers and utilities on your local network, without much mucking about configuring DHCP and TFTP servers, using the excellent netboot.xyz project. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1921/dhcp-netboot

## Description

This Docker container lets you PXE boot a bunch of installers and utilities on your local network, without much mucking about configuring DHCP and TFTP servers, using the excellent netboot.xyz project.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

33/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 1571 days ago)
- Popular: 41 (106 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/samdbmg/dhcp-netboot.xyz
- Unraid: https://ca.unraid.net/apps/dhcp-netboot-0z1b58h1lbgyst?q=DHCP-Netboot

## Common questions

### Do I need to replace my router’s DHCP server?

No, it uses a ProxyDHCP service so your existing DHCP server can keep assigning IP addresses normally. When a PXE client sends a DHCP request, the container also announces itself as a TFTP boot target.

### Which firewall ports must be open for it to work?

Allow UDP 67 for DHCP, UDP 69 for TFTP, and UDP 4011 for PXE. Also allow TCP 80 for the built-in web server, then remove the firewall rules when finished.

### How do I configure the IP range it uses?

Set the DHCP_RANGE_START environment variable to the first address on your network. dnsmasq determines the correct subnet mask from your local network setup.

### Why does the Docker run command require --net=host and NET_ADMIN?

The container needs low-level access to the target network instead of Docker’s internal bridge so it can respond to PXE DHCP requests. It also needs to expose the DHCP, TFTP, PXE, and HTTP ports directly.

---
Source: Our Local Host (https://ourlocalhost.com/app/1921/dhcp-netboot), the self-hosted and open-source app directory.
