Jakub Pavlik | 1af183b | 2015-02-22 18:25:28 +0100 | [diff] [blame] | 1 | # 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 Pavlik | c75247d | 2015-02-23 09:18:02 +0100 | [diff] [blame^] | 35 | listen_tls = 0 |
| 36 | listen_tcp = 1 |
| 37 | auth_tcp="none" |
Jakub Pavlik | 1af183b | 2015-02-22 18:25:28 +0100 | [diff] [blame] | 38 | |
| 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. |
| 84 | unix_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. |
| 91 | unix_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. |
| 101 | unix_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 |
| 132 | auth_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 |
| 141 | auth_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 |