blob: 2897b90300cb1707dc3de2990bdf9ce7da6785e6 [file] [log] [blame]
Patrick Williamsb48b7b42016-08-17 15:04:38 -05001# Configuration file for dnsmasq.
2#
3# Format is one option per line, legal options are the same
4# as the long options legal on the command line. See
Brad Bishop8410d612019-11-25 09:40:59 -05005# "/usr/bin/dnsmasq --help" or "man 8 dnsmasq" for details.
Patrick Williamsb48b7b42016-08-17 15:04:38 -05006
Brad Bishop6e60e8b2018-02-01 10:27:11 -05007# Listen on this specific port instead of the standard DNS port
8# (53). Setting this to zero completely disables DNS function,
9# leaving only DHCP and/or TFTP.
10#port=5353
11
Patrick Williamsb48b7b42016-08-17 15:04:38 -050012# Change these lines if you want dnsmasq to serve MX records.
13# Only one of mx-host and mx-target need be set, the other defaults
14# to the name of the host running dnsmasq.
15#mx-host=
16#mx-target=
17#selfmx
18#localmx
19
20# The following two options make you a better netizen, since they
21# tell dnsmasq to filter out queries which the public DNS cannot
22# answer, and which load the servers (especially the root servers)
23# uneccessarily. If you have a dial-on-demand link they also stop
24# these requests from bringing up the link uneccessarily.
25
26# Never forward plain names (with a dot or domain part)
27domain-needed
28# Never forward addresses in the non-routed address spaces.
29bogus-priv
30
31
32# Uncomment this to filter useless windows-originated DNS requests
33# which can trigger dial-on-demand links needlessly.
34# Note that (amongst other things) this blocks all SRV requests,
35# so don't use it if you use eg Kerberos.
36#filterwin2k
37
38# Change this line if you want dns to get its upstream servers from
39# somewhere other that /etc/resolv.conf
40#resolv-file=
41
42# By default, dnsmasq will send queries to any of the upstream
43# servers it knows about and tries to favour servers to are known
44# to be up. Uncommenting this forces dnsmasq to try each query
45# with each server strictly in the order they appear in
46# /etc/resolv.conf
47#strict-order
48
49# If you don't want dnsmasq to read /etc/resolv.conf or any other
50# file, getting its servers for this file instead (see below), then
51# uncomment this
52#no-resolv
53
54# If you don't want dnsmasq to poll /etc/resolv.conf or other resolv
55# files for changes and re-read them then uncomment this.
56#no-poll
57
58# Add other name servers here, with domain specs if they are for
59# non-public domains.
60#server=/localnet/192.168.0.1
61
62# Add local-only domains here, queries in these domains are answered
63# from /etc/hosts or DHCP only.
64#local=/localnet/
65
66# Add domains which you want to force to an IP address here.
67# The example below send any host in doubleclick.net to a local
68# webserver.
69#address=/doubleclick.net/127.0.0.1
70
71# You no longer (as of version 1.7) need to set these to enable
72# dnsmasq to read /etc/ppp/resolv.conf since dnsmasq now uses the
73# "dip" group to achieve this.
74#user=
75#group=
76
77# If you want dnsmasq to listen for requests only on specified interfaces
78# (and the loopback) give the name of the interface (eg eth0) here.
79# Repeat the line for more than one interface.
80#interface=
81# Or you can specify which interface _not_ to listen on
82#except-interface=
83# Or which to listen on by address (remember to include 127.0.0.1 if
84# you use this.)
Brad Bishop7f28bc52017-12-03 23:42:40 -050085#listen-address=127.0.0.1
Patrick Williamsb48b7b42016-08-17 15:04:38 -050086
87# On systems which support it, dnsmasq binds the wildcard address,
88# even when it is listening on only some interfaces. It then discards
89# requests that it shouldn't reply to. This has the advantage of
90# working even when interfaces come and go and change address. If you
91# want dnsmasq to really bind only the interfaces it is listening on,
92# uncomment this option. About the only time you may need this is when
93# running another nameserver on the same machine.
94#bind-interfaces
95
96# If you don't want dnsmasq to read /etc/hosts, uncomment the
97# following line.
98#no-hosts
99# or if you want it to read another file, as well as /etc/hosts, use
100# this.
101#addn-hosts=/etc/banner_add_hosts
102
103# Set this (and domain: see below) if you want to have a domain
104# automatically added to simple names in a hosts-file.
105#expand-hosts
106
107# Set the domain for dnsmasq. this is optional, but if it is set, it
108# does the following things.
109# 1) Allows DHCP hosts to have fully qualified domain names, as long
110# as the domain part matches this setting.
111# 2) Sets the "domain" DHCP option thereby potentially setting the
112# domain of all systems configured by DHCP
113# 3) Provides the domain part for "expand-hosts"
114#domain=thekelleys.org.uk
115
116# Uncomment this to enable the integrated DHCP server, you need
117# to supply the range of addresses available for lease and optionally
118# a lease time. If you have more than one network, you will need to
119# repeat this for each network on which you want to supply DHCP
120# service.
121#dhcp-range=192.168.0.50,192.168.0.150,12h
122#dhcp-range=10.0.0.10,10.0.0.200,2h
123
124# This is an example of a DHCP range where the netmask is given. This
125# is needed for networks we reach the dnsmasq DHCP server via a relay
126# agent. If you don't know what a DHCP relay agent is, you probably
127# don't need to worry about this.
128#dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h
129
130# This is an example of a DHCP range with a network-id, so that
131# some DHCP options may be set only for this network.
132#dhcp-range=red,192.168.0.50,192.168.0.150
133
134# Supply parameters for specified hosts using DHCP. There are lots
135# of valid alternatives, so we will give examples of each. Note that
136# IP addresses DO NOT have to be in the range given above, they just
137# need to be on the same network. The order of the parameters in these
138# do not matter, it's permissble to give name,adddress and MAC in any order
139
140# Always allocate the host with ethernet address 11:22:33:44:55:66
141# The IP address 192.168.0.60
142#dhcp-host=11:22:33:44:55:66,192.168.0.60
143
144# Always set the name of the host with hardware address
145# 11:22:33:44:55:66 to be "fred"
146#dhcp-host=11:22:33:44:55:66,fred
147
148# Always give the host with ethernet address 11:22:33:44:55:66
149# the name fred and IP address 192.168.0.60 and lease time 45 minutes
150#dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m
151
152# Give the machine which says it's name is "bert" IP address
153# 192.168.0.70 and an infinite lease
154#dhcp-host=bert,192.168.0.70,infinite
155
156# Always give the host with client identifier 01:02:02:04
157# the IP address 192.168.0.60
158#dhcp-host=id:01:02:02:04,192.168.0.60
159
160# Always give the host with client identifier "marjorie"
161# the IP address 192.168.0.60
162#dhcp-host=id:marjorie,192.168.0.60
163
164# Enable the address given for "judge" in /etc/hosts
165# to be given to a machine presenting the name "judge" when
166# it asks for a DHCP lease.
167#dhcp-host=judge
168
169# Never offer DHCP service to a machine whose ethernet
170# address is 11:22:33:44:55:66
171#dhcp-host=11:22:33:44:55:66,ignore
172
173# Ignore any client-id presented by the machine with ethernet
174# address 11:22:33:44:55:66. This is useful to prevent a machine
175# being treated differently when running under different OS's or
176# between PXE boot and OS boot.
177#dhcp-host=11:22:33:44:55:66,id:*
178
179# Send extra options which are tagged as "red" to
180# the machine with ethernet address 11:22:33:44:55:66
181#dhcp-host=11:22:33:44:55:66,net:red
182
183# Send extra options which are tagged as "red" to any machine whose
184# DHCP vendorclass string includes the substring "Linux"
185#dhcp-vendorclass=red,Linux
186
187# Send extra options which are tagged as "red" to any machine one
188# of whose DHCP userclass strings includes the substring "accounts"
189#dhcp-userclass=red,accounts
190
191# If this line is uncommented, dnsmasq will read /etc/ethers and act
192# on the ethernet-address/IP pairs found there just as if they had
193# been given as --dhcp-host options. Useful if you keep
194# MAC-address/host mappings there for other purposes.
195#read-ethers
196
197# Send options to hosts which ask for a DHCP lease.
198# See RFC 2132 for details of available options.
199# Note that all the common settings, such as netmask and
200# broadcast address, DNS server and default route, are given
201# sane defaults by dnsmasq. You very likely will not need any
202# any dhcp-options. If you use Windows clients and Samba, there
203# are some options which are recommended, they are detailed at the
204# end of this section.
205# For reference, the common options are:
206# subnet mask - 1
207# default router - 3
208# DNS server - 6
209# broadcast address - 28
210
211# Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
212#dhcp-option=42,192.168.0.4,10.10.0.5
213
214# Set the NTP time server address to be the same machine as
215# is running dnsmasq
216#dhcp-option=42,0.0.0.0
217
218# Set the NIS domain name to "welly"
219#dhcp-option=40,welly
220
221# Set the default time-to-live to 50
222#dhcp-option=23,50
223
224# Set the "all subnets are local" flag
225#dhcp-option=27,1
226
227# Send the etherboot magic flag and then etherboot options (a string).
228#dhcp-option=128,e4:45:74:68:00:00
229#dhcp-option=129,NIC=eepro100
230
231# Specify an option which will only be sent to the "red" network
232# (see dhcp-range for the declaration of the "red" network)
233#dhcp-option=red,42,192.168.1.1
234
235# The following DHCP options set up dnsmasq in the same way as is specified
236# for the ISC dhcpcd in
237# http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
238# adapted for a typical dnsmasq installation where the host running
239# dnsmasq is also the host running samba.
240# you may want to uncomment them if you use Windows clients and Samba.
241#dhcp-option=19,0 # option ip-forwarding off
242#dhcp-option=44,0.0.0.0 # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
243#dhcp-option=45,0.0.0.0 # netbios datagram distribution server
244#dhcp-option=46,8 # netbios node type
245#dhcp-option=47 # empty netbios scope.
246
247
248# Set the boot filename and tftpd server name and address
249# for BOOTP. You will only need this is you want to
250# boot machines over the network.
251#dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3
252
253# Set the limit on DHCP leases, the default is 150
254#dhcp-lease-max=150
255
256# The DHCP server needs somewhere on disk to keep its lease database.
257# This defaults to a sane location, but if you want to change it, use
258# the line below.
259#dhcp-leasefile=/var/lib/misc/dnsmasq.leases
260
261# Set the cachesize here.
262#cache-size=150
263
264# If you want to disable negative caching, uncomment this.
265#no-negcache
266
267# Normally responses which come form /etc/hosts and the DHCP lease
268# file have Time-To-Live set as zero, which conventionally means
269# do not cache further. If you are happy to trade lower load on the
270# server for potentially stale date, you can set a time-to-live (in
271# seconds) here.
272#local-ttl=
273
274# If you want dnsmasq to detect attempts by Verisign to send queries
275# to unregistered .com and .net hosts to its sitefinder service and
276# have dnsmasq instead return the correct NXDOMAIN response, uncomment
277# this line. You can add similar lines to do the same for other
278# registries which have implemented wildcard A records.
279#bogus-nxdomain=64.94.110.11
280
281# If you want to fix up DNS results from upstream servers, use the
282# alias option. This only works for IPv4.
283# This alias makes a result of 1.2.3.4 appear as 5.6.7.8
284#alias=1.2.3.4,5.6.7.8
285# and this maps 1.2.3.x to 5.6.7.x
286#alias=1.2.3.0,5.6.7.0,255.255.255.0
287
288# For debugging purposes, log each DNS query as it passes through
289# dnsmasq.
290#log-queries
291
292# Include a another lot of configuration options.
293#conf-file=/etc/dnsmasq.more.conf
294
295
296
297
298