khuedoan-homelab/docs/how-to-guides/disable-dhcp-proxy-in-dnsmasq.md
Khue Doan 1405fadf1a refactor(docs): apply the Diátaxis framework
Squashed commit of the following:

commit 257867f196376df55fa0f57edbdf33967b1da04e
Author: Khue Doan <mail@khuedoan.com>
Date:   Sun Sep 18 16:45:42 2022 +0700

    refactor(docs): apply the Diátaxis framework
2022-09-19 02:40:07 +07:00

15 lines
683 B
Markdown

# Disable DHCP proxy in dnsmasq
## Overview
Dnsmasq is used as either a DHCP server or DHCP proxy server for PXE metal provisioning.
Proxy mode is enabled by default allowing the use of existing DHCP servers on the network.
A good description on how DHCP Proxy works can be found on the related [FOG project wiki page](https://wiki.fogproject.org/wiki/index.php?title=ProxyDHCP_with_dnsmasq).
## Disabling Proxy mode
Certain scenarios will require this project to use a DHCP server, such as an air-gap deployment or dedicated VLAN.
To disable proxy mode thereby using dnsmasq as a DHCP server, modify `metal/roles/pxe_server/defaults/main.yml` and set `dhcp_proxy` to `false`.