blob: 25814b1831e16681a2ba9a96666754f40aff12c1 [file] [log] [blame]
Jakub Pavlik1af183b2015-02-22 18:25:28 +01001# Master libvirt daemon configuration file
2#
3# For further information consult http://libvirt.org/format.html
4#
5# NOTE: the tests/daemon-conf regression test script requires
6# that each "PARAMETER = VALUE" line in this file have the parameter
7# name just after a leading "#".
8
9#################################################################
10#
11# Network connectivity controls
12#
13
14# Flag listening for secure TLS connections on the public TCP/IP port.
15# NB, must pass the --listen flag to the libvirtd process for this to
16# have any effect.
17#
18# It is necessary to setup a CA and issue server certificates before
19# using this capability.
20#
21# This is enabled by default, uncomment this to disable it
22#listen_tls = 0
23
24# Listen for unencrypted TCP connections on the public TCP/IP port.
25# NB, must pass the --listen flag to the libvirtd process for this to
26# have any effect.
27#
28# Using the TCP socket requires SASL authentication by default. Only
29# SASL mechanisms which support data encryption are allowed. This is
30# DIGEST_MD5 and GSSAPI (Kerberos5)
31#
32# This is disabled by default, uncomment this to enable it.
33#listen_tcp = 1
34
Jakub Pavlikc75247d2015-02-23 09:18:02 +010035listen_tls = 0
36listen_tcp = 1
37auth_tcp="none"
Jakub Pavlik1af183b2015-02-22 18:25:28 +010038
39
40# Override the port for accepting secure TLS connections
41# This can be a port number, or service name
42#
43#tls_port = "16514"
44
45# Override the port for accepting insecure TCP connections
46# This can be a port number, or service name
47#
48#tcp_port = "16509"
49
50
51# Override the default configuration which binds to all network
52# interfaces. This can be a numeric IPv4/6 address, or hostname
53#
54#listen_addr = "192.168.0.1"
55
56
57# Flag toggling mDNS advertizement of the libvirt service.
58#
59# Alternatively can disable for all services on a host by
60# stopping the Avahi daemon
61#
62# This is disabled by default, uncomment this to enable it
63#mdns_adv = 1
64
65# Override the default mDNS advertizement name. This must be
66# unique on the immediate broadcast network.
67#
68# The default is "Virtualization Host HOSTNAME", where HOSTNAME
69# is substituted for the short hostname of the machine (without domain)
70#
71#mdns_name = "Virtualization Host Joe Demo"
72
73
74#################################################################
75#
76# UNIX socket access controls
77#
78
79# Set the UNIX domain socket group ownership. This can be used to
80# allow a 'trusted' set of users access to management capabilities
81# without becoming root.
82#
83# This is restricted to 'root' by default.
84unix_sock_group = "libvirtd"
85
86# Set the UNIX socket permissions for the R/O socket. This is used
87# for monitoring VM status only
88#
89# Default allows any user. If setting group ownership, you may want to
90# restrict this too.
91unix_sock_ro_perms = "0777"
92
93# Set the UNIX socket permissions for the R/W socket. This is used
94# for full management of VMs
95#
96# Default allows only root. If PolicyKit is enabled on the socket,
97# the default will change to allow everyone (eg, 0777)
98#
99# If not using PolicyKit and setting group ownership for access
100# control, then you may want to relax this too.
101unix_sock_rw_perms = "0770"
102
103# Set the name of the directory in which sockets will be found/created.
104#unix_sock_dir = "/var/run/libvirt"
105
106#################################################################
107#
108# Authentication.
109#
110# - none: do not perform auth checks. If you can connect to the
111# socket you are allowed. This is suitable if there are
112# restrictions on connecting to the socket (eg, UNIX
113# socket permissions), or if there is a lower layer in
114# the network providing auth (eg, TLS/x509 certificates)
115#
116# - sasl: use SASL infrastructure. The actual auth scheme is then
117# controlled from /etc/sasl2/libvirt.conf. For the TCP
118# socket only GSSAPI & DIGEST-MD5 mechanisms will be used.
119# For non-TCP or TLS sockets, any scheme is allowed.
120#
121# - polkit: use PolicyKit to authenticate. This is only suitable
122# for use on the UNIX sockets. The default policy will
123# require a user to supply their own password to gain
124# full read/write access (aka sudo like), while anyone
125# is allowed read/only access.
126#
127# Set an authentication scheme for UNIX read-only sockets
128# By default socket permissions allow anyone to connect
129#
130# To restrict monitoring of domains you may wish to enable
131# an authentication mechanism here
132auth_unix_ro = "none"
133
134# Set an authentication scheme for UNIX read-write sockets
135# By default socket permissions only allow root. If PolicyKit
136# support was compiled into libvirt, the default will be to
137# use 'polkit' auth.
138#
139# If the unix_sock_rw_perms are changed you may wish to enable
140# an authentication mechanism here
141auth_unix_rw = "none"
142
143# Change the authentication scheme for TCP sockets.
144#
145# If you don't enable SASL, then all TCP traffic is cleartext.
146# Don't do this outside of a dev/test scenario. For real world
147# use, always enable SASL and use the GSSAPI or DIGEST-MD5
148# mechanism in /etc/sasl2/libvirt.conf
149#auth_tcp = "sasl"
150
151# Change the authentication scheme for TLS sockets.
152#
153# TLS sockets already have encryption provided by the TLS
154# layer, and limited authentication is done by certificates
155#
156# It is possible to make use of any SASL authentication
157# mechanism as well, by using 'sasl' for this option
158#auth_tls = "none"
159
160
161# Change the API access control scheme
162#
163# By default an authenticated user is allowed access
164# to all APIs. Access drivers can place restrictions
165# on this. By default the 'nop' driver is enabled,
166# meaning no access control checks are done once a
167# client has authenticated with libvirtd
168#
169#access_drivers = [ "polkit" ]
170
171#################################################################
172#
173# TLS x509 certificate configuration
174#
175
176
177# Override the default server key file path
178#
179#key_file = "/etc/pki/libvirt/private/serverkey.pem"
180
181# Override the default server certificate file path
182#
183#cert_file = "/etc/pki/libvirt/servercert.pem"
184
185# Override the default CA certificate path
186#
187#ca_file = "/etc/pki/CA/cacert.pem"
188
189# Specify a certificate revocation list.
190#
191# Defaults to not using a CRL, uncomment to enable it
192#crl_file = "/etc/pki/CA/crl.pem"
193
194
195
196#################################################################
197#
198# Authorization controls
199#
200
201
202# Flag to disable verification of our own server certificates
203#
204# When libvirtd starts it performs some sanity checks against
205# its own certificates.
206#
207# Default is to always run sanity checks. Uncommenting this
208# will disable sanity checks which is not a good idea
209#tls_no_sanity_certificate = 1
210
211# Flag to disable verification of client certificates
212#
213# Client certificate verification is the primary authentication mechanism.
214# Any client which does not present a certificate signed by the CA
215# will be rejected.
216#
217# Default is to always verify. Uncommenting this will disable
218# verification - make sure an IP whitelist is set
219#tls_no_verify_certificate = 1
220
221
222# A whitelist of allowed x509 Distinguished Names
223# This list may contain wildcards such as
224#
225# "C=GB,ST=London,L=London,O=Red Hat,CN=*"
226#
227# See the POSIX fnmatch function for the format of the wildcards.
228#
229# NB If this is an empty list, no client can connect, so comment out
230# entirely rather than using empty list to disable these checks
231#
232# By default, no DN's are checked
233#tls_allowed_dn_list = ["DN1", "DN2"]
234
235
236# A whitelist of allowed SASL usernames. The format for usernames
237# depends on the SASL authentication mechanism. Kerberos usernames
238# look like username@REALM
239#
240# This list may contain wildcards such as
241#
242# "*@EXAMPLE.COM"
243#
244# See the POSIX fnmatch function for the format of the wildcards.
245#
246# NB If this is an empty list, no client can connect, so comment out
247# entirely rather than using empty list to disable these checks
248#
249# By default, no Username's are checked
250#sasl_allowed_username_list = ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM" ]
251
252
253
254#################################################################
255#
256# Processing controls
257#
258
259# The maximum number of concurrent client connections to allow
260# over all sockets combined.
261#max_clients = 20
262
263# The maximum length of queue of connections waiting to be
264# accepted by the daemon. Note, that some protocols supporting
265# retransmission may obey this so that a later reattempt at
266# connection succeeds.
267#max_queued_clients = 1000
268
269
270# The minimum limit sets the number of workers to start up
271# initially. If the number of active clients exceeds this,
272# then more threads are spawned, up to max_workers limit.
273# Typically you'd want max_workers to equal maximum number
274# of clients allowed
275#min_workers = 5
276#max_workers = 20
277
278
279# The number of priority workers. If all workers from above
280# pool are stuck, some calls marked as high priority
281# (notably domainDestroy) can be executed in this pool.
282#prio_workers = 5
283
284# Total global limit on concurrent RPC calls. Should be
285# at least as large as max_workers. Beyond this, RPC requests
286# will be read into memory and queued. This directly impacts
287# memory usage, currently each request requires 256 KB of
288# memory. So by default up to 5 MB of memory is used
289#
290# XXX this isn't actually enforced yet, only the per-client
291# limit is used so far
292#max_requests = 20
293
294# Limit on concurrent requests from a single client
295# connection. To avoid one client monopolizing the server
296# this should be a small fraction of the global max_requests
297# and max_workers parameter
298#max_client_requests = 5
299
300#################################################################
301#
302# Logging controls
303#
304
305# Logging level: 4 errors, 3 warnings, 2 information, 1 debug
306# basically 1 will log everything possible
307#log_level = 3
308
309# Logging filters:
310# A filter allows to select a different logging level for a given category
311# of logs
312# The format for a filter is one of:
313# x:name
314# x:+name
315# where name is a string which is matched against source file name,
316# e.g., "remote", "qemu", or "util/json", the optional "+" prefix
317# tells libvirt to log stack trace for each message matching name,
318# and x is the minimal level where matching messages should be logged:
319# 1: DEBUG
320# 2: INFO
321# 3: WARNING
322# 4: ERROR
323#
324# Multiple filters can be defined in a single @filters, they just need to be
325# separated by spaces.
326#
327# e.g. to only get warning or errors from the remote layer and only errors
328# from the event layer:
329#log_filters="3:remote 4:event"
330
331# Logging outputs:
332# An output is one of the places to save logging information
333# The format for an output can be:
334# x:stderr
335# output goes to stderr
336# x:syslog:name
337# use syslog for the output and use the given name as the ident
338# x:file:file_path
339# output to a file, with the given filepath
340# In all case the x prefix is the minimal level, acting as a filter
341# 1: DEBUG
342# 2: INFO
343# 3: WARNING
344# 4: ERROR
345#
346# Multiple outputs can be defined, they just need to be separated by spaces.
347# e.g. to log all warnings and errors to syslog under the libvirtd ident:
348#log_outputs="3:syslog:libvirtd"
349#
350
351# Log debug buffer size: default 64
352# The daemon keeps an internal debug log buffer which will be dumped in case
353# of crash or upon receiving a SIGUSR2 signal. This setting allows to override
354# the default buffer size in kilobytes.
355# If value is 0 or less the debug log buffer is deactivated
356#log_buffer_size = 64
357
358
359##################################################################
360#
361# Auditing
362#
363# This setting allows usage of the auditing subsystem to be altered:
364#
365# audit_level == 0 -> disable all auditing
366# audit_level == 1 -> enable auditing, only if enabled on host (default)
367# audit_level == 2 -> enable auditing, and exit if disabled on host
368#
369#audit_level = 2
370#
371# If set to 1, then audit messages will also be sent
372# via libvirt logging infrastructure. Defaults to 0
373#
374#audit_logging = 1
375
376###################################################################
377# UUID of the host:
378# Provide the UUID of the host here in case the command
379# 'dmidecode -s system-uuid' does not provide a valid uuid. In case
380# 'dmidecode' does not provide a valid UUID and none is provided here, a
381# temporary UUID will be generated.
382# Keep the format of the example UUID below. UUID must not have all digits
383# be the same.
384
385# NB This default all-zeros UUID will not work. Replace
386# it with the output of the 'uuidgen' command and then
387# uncomment this entry
388#host_uuid = "00000000-0000-0000-0000-000000000000"
389
390###################################################################
391# Keepalive protocol:
392# This allows libvirtd to detect broken client connections or even
393# dead clients. A keepalive message is sent to a client after
394# keepalive_interval seconds of inactivity to check if the client is
395# still responding; keepalive_count is a maximum number of keepalive
396# messages that are allowed to be sent to the client without getting
397# any response before the connection is considered broken. In other
398# words, the connection is automatically closed approximately after
399# keepalive_interval * (keepalive_count + 1) seconds since the last
400# message received from the client. If keepalive_interval is set to
401# -1, libvirtd will never send keepalive requests; however clients
402# can still send them and the daemon will send responses. When
403# keepalive_count is set to 0, connections will be automatically
404# closed after keepalive_interval seconds of inactivity without
405# sending any keepalive messages.
406#
407#keepalive_interval = 5
408#keepalive_count = 5
409#
410# If set to 1, libvirtd will refuse to talk to clients that do not
411# support keepalive protocol. Defaults to 0.
412#
413#keepalive_required = 1