LTSP-DNSMASQ(8)

📦
version 23.02 · 6 versions
, in debian trixie, ubuntu questing

💅 LTSP-DNSMASQ(8) — the ltsp dnsmasq glow-up guide ✨

okay bestie, so this is a page from the LTSP Manual, and it's literally all about making dnsmasq behave for your LTSP server. no cap. 🎀

🌸 NAME 🌸

ltsp dnsmasq — configure dnsmasq for LTSP 💖

✨ SYNOPSIS ✨

ltsp [ltsp-options] dnsmasq [-d dns] [-p proxy-dhcp] [-r real-dhcp] [-s
dns-server] [-t tftp]

🦋 DESCRIPTION 🦋

It installs /etc/dnsmasq.d/ltsp-dnsmasq.conf, but the way it does that is by taking a template and adjusting it with whatever parameters you handed it. so it's not just a copy-paste situation, it's a customized situation 💅

👑 OPTIONS 👑

first things first, the ltsp-options? those live in the ltsp(8) man page. go check her out. 🫶

  • -d, --dns=0|1 — turn the DNS service on or off. defaults to 0. turning on dnsmasq's DNS service unlocks caching of client requests, custom DNS results, blacklisting, all that good stuff — and it automatically disables DNSStubListener in systemd-resolved on the LTSP server. so like, it handles that for you, iconic. ✨
  • -p, --proxy-dhcp=0|1 — turn the proxy DHCP service on or off. defaults to 1. so what even is proxy DHCP? it means the LTSP server sends the boot filename, but it leaves the actual IP leasing to an external DHCP server — think a router, or pfsense, or a Windows DHCP server. it's genuinely the easiest way to set up LTSP, because it only needs a single NIC, no static IP, no rewiring switches, none of that. lowkey a dream. 😌
  • -r, --real-dhcp=0|1 — turn the real DHCP service on or off. defaults to 1. in dual NIC setups you only need to configure the internal NIC to a static IP of 192.168.67.1, and LTSP will try to autodetect everything else. here's the tea though: the real DHCP service doesn't take effect if your IP isn't 192.168.67.x, so there's no need to disable it in single NIC setups — unless you wanna run isc-dhcp-server on the LTSP server, in which case go off. 💀
  • -s, --dns-server="space separated list" — set the DNS server DHCP option. defaults to autodetection. important thing to know: proxy DHCP clients don't receive DHCP options, so when autodetection isn't appropriate, you should use the ltsp.conf DNS_SERVER parameter instead. 🧚
  • -t, --tftp=0|1 — turn the TFTP service on or off. defaults to 1.

🌈 EXAMPLES 🌈

Wanna create a default dnsmasq configuration and overwrite the old one? periodt:

ltsp dnsmasq

Wanna do a dual NIC setup with the DNS service enabled? slay:

ltsp dnsmasq -d1 -p0 --dns-server="0.0.0.0 8.8.8.8 208.67.222.222"

Copyright 2019-2022 the LTSP team, see AUTHORS.

⭐ SEE ALSO ⭐

ltsp(8), ltsp.conf(5), ltsp-image(8), ltsp-info(8), ltsp-initrd(8), ltsp-ipxe(8), ltsp-kernel(8), ltsp-nfs(8), ltsp-remoteapps(8)

Online documentation is available on https://ltsp.org

okay that's the whole thing, bestie, you ate that 🫶 this was LTSP 23.02-3, dated 2024-09-07, and yeah — that's the LTSP-DNSMASQ(8) main character energy, mwah 💅✨

📦 where this page comes from