Update deployments/automation/FOG Project/Configure Pi-Hole PXE Boot.md
All checks were successful
Automatic Documentation Deployment / Sync Docs to https://kb.bunny-lab.io (push) Successful in 5s

This commit is contained in:
2026-05-04 19:48:30 -06:00
parent 3816d2bf84
commit 19584733e7

View File

@@ -1,16 +1,23 @@
## Purpose
This document was written to provide instructions for setting up a FOG Project server behind a Pi-Hole that has DHCP configured on it. Start by connecting to the Pi-Hole's CLI either via SSH or Portainer/Docker Interactive CLI and run `vi /etc/dnsmasq.d/99-pxe.conf`
This document was written to provide instructions for setting up a FOG Project server behind a Pi-Hole that has DHCP configured on it. Start by connecting to the Pi-Hole's CLI either via SSH or Portainer/Docker Interactive CLI and create the following file:
### Configure PXE Records
```ini title="/etc/dnsmasq.d/99-pxe.conf"
# Detect if client is already using iPXE
dhcp-userclass=set:ipxe,iPXE
# If already in iPXE → send to FOG menu
dhcp-boot=tag:ipxe,http://192.168.3.9/fog/service/ipxe/boot.php
```ini title="docker-compose.yml"
# Detect UEFI x64 clients
dhcp-match=set:efi-x86_64,option:client-arch,7
# UEFI boot file
# First-stage boot loaders
dhcp-boot=tag:efi-x86_64,snponly.efi,,192.168.3.9
# Default (BIOS)
dhcp-boot=undionly.kpxe,,192.168.3.9
# Optional (explicit next-server)
dhcp-option=66,192.168.3.9
```
### Reload Pi-Hole DNS
```sh
pihole reloaddns
```