1
Notes on configuring the Debian package of dnsmasq.
3
(1) To configure dnsmasq edit /etc/default/dnsmasq.
4
This file includes options to pick up DHCP-allocated addresses
5
from the ISC dhpcd leases file and to use the other features
6
detailed in dnsmasq(8).
8
(2) The Debian dhcpcd package makes /etc/resolv.conf a link to
9
/etc/dhcpc/resolv.conf. If you want to use automatic DNS configuration
10
via DHCP, you will have to remove this link before setting the
11
configuration as described in /usr/share/doc/dnsmasq/doc.html.
1
Notes on configuring dnsmasq as packaged for Debian.
3
(1) To configure dnsmasq edit /etc/dnsmasq.conf. The file is well
4
commented; see also the dnsmasq.8 man page for explanation of
5
the options. The file /etc/default/dnsmasq also exists but it
6
shouldn't need to be touched in most cases. To set up DHCP
7
options you might need to refer to a copy of RFC 2132. This is
8
available on Debian systems in the package doc-rfc-std as the file
9
/usr/share/doc/RFC/draft-standard/rfc2132.txt.gz .
11
(2) If the Debian resolvconf package is installed then, regardless
12
of what interface configuration daemons are employed, the list of
13
nameservers to which dnsmasq should forward queries can be found
14
in /var/run/dnsmasq/resolv.conf; also, 127.0.0.1 is listed as the
15
first nameserver address in /etc/resolv.conf. This works using the
16
default configurations of resolvconf and dnsmasq.
18
(3) In the absence of resolvconf, if you are using dhcpcd then
19
dnsmasq should read the list of nameservers from the automatically
20
generated file /etc/dhcpc/resolv.conf. You should list 127.0.0.1
21
as the first nameserver address in /etc/resolv.conf.
23
(4) In the absence of resolvconf, if you are using pppd then
24
dnsmasq should read the list of nameservers from the automatically
25
generated file /etc/ppp/resolv.conf. You should list 127.0.0.1
26
as the first nameserver address in /etc/resolv.conf.
28
(5) If you run multiple DNS servers on a single machine, each
29
listening on a different interface, then it is necessary from
30
version 2.3 on to use the bind-interfaces option by uncommenting
31
"bind-interfaces" in /etc/dnsmasq.conf. This option stops dnsmasq
32
from binding the wildcard address and allows servers listening on
33
port 53 on interfaces not in use by dnsmasq to work.