khuedoan-homelab/docs/runbooks/dnsmasq.md

# 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`
refactor(pxe)!: combine dhcpd and tftpd to dnsmasq (#69) * Add DNSMasq as an opt-in option * Default to original * Remove commented commands * Remove dhcpd, replaced with dnsmasq * Remove dhcpd, replaced with dnsmasq * Move to dnsmasq * dnsmasq output to stdout * dnsmasq * dnsmasq * Remove unused code, update tag * Correct title Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Remove TFTP Co-authored-by: Khue Doan <khuedoan98@gmail.com> * rename to Dnsmasq Moving to use proxy by default Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Rename for consistency Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Correct terminology Co-authored-by: Khue Doan <khuedoan98@gmail.com> * formatting Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Additional logging * proxy-by-default * naming consistency * naming consistency * Revert Dnsmasq proxy ask * proxy enabled by default * naming consistency * naming consistency * Formatting Co-authored-by: Robin Bourne <robin.bourne@onepeloton.com> Co-authored-by: Khue Doan <khuedoan98@gmail.com> 2022-07-18 01:39:02 +07:00			`# Dnsmasq`

			`## Overview`
docs: add dnsmasq runbook to index 2022-07-18 01:50:48 +07:00
docs: add more secrets management details 2022-07-24 00:14:12 +07:00			`Dnsmasq is used as either a DHCP server or DHCP proxy server for PXE metal provisioning.`
refactor(pxe)!: combine dhcpd and tftpd to dnsmasq (#69) * Add DNSMasq as an opt-in option * Default to original * Remove commented commands * Remove dhcpd, replaced with dnsmasq * Remove dhcpd, replaced with dnsmasq * Move to dnsmasq * dnsmasq output to stdout * dnsmasq * dnsmasq * Remove unused code, update tag * Correct title Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Remove TFTP Co-authored-by: Khue Doan <khuedoan98@gmail.com> * rename to Dnsmasq Moving to use proxy by default Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Rename for consistency Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Correct terminology Co-authored-by: Khue Doan <khuedoan98@gmail.com> * formatting Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Additional logging * proxy-by-default * naming consistency * naming consistency * Revert Dnsmasq proxy ask * proxy enabled by default * naming consistency * naming consistency * Formatting Co-authored-by: Robin Bourne <robin.bourne@onepeloton.com> Co-authored-by: Khue Doan <khuedoan98@gmail.com> 2022-07-18 01:39:02 +07:00
docs: add dnsmasq runbook to index 2022-07-18 01:50:48 +07:00			`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)`
refactor(pxe)!: combine dhcpd and tftpd to dnsmasq (#69) * Add DNSMasq as an opt-in option * Default to original * Remove commented commands * Remove dhcpd, replaced with dnsmasq * Remove dhcpd, replaced with dnsmasq * Move to dnsmasq * dnsmasq output to stdout * dnsmasq * dnsmasq * Remove unused code, update tag * Correct title Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Remove TFTP Co-authored-by: Khue Doan <khuedoan98@gmail.com> * rename to Dnsmasq Moving to use proxy by default Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Rename for consistency Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Correct terminology Co-authored-by: Khue Doan <khuedoan98@gmail.com> * formatting Co-authored-by: Khue Doan <khuedoan98@gmail.com> * Additional logging * proxy-by-default * naming consistency * naming consistency * Revert Dnsmasq proxy ask * proxy enabled by default * naming consistency * naming consistency * Formatting Co-authored-by: Robin Bourne <robin.bourne@onepeloton.com> Co-authored-by: Khue Doan <khuedoan98@gmail.com> 2022-07-18 01:39:02 +07:00
			`## Disabling Proxy Mode`

docs: add dnsmasq runbook to index 2022-07-18 01:50:48 +07:00			`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`