blob: 6dc0cfe169eb4334a1fbf28c31982bb850651d3f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
---
layout: "libvirt"
page_title: "Provider: libvirt"
sidebar_current: "docs-libvirt-index"
description: |-
The Libvirt provider is used to interact with Linux KVM/libvirt hypervisors. The provider needs to be configured with the proper connection information before it can be used.
---
# Libvirt Provider
The Libvirt provider is used to interact with Linux
[libvirt](https://libvirt.org) hypervisors.
The provider needs to be configured with the proper connection information
before it can be used.
~> **Note:** while libvirt can be used with several types of hypervisors, this
provider focuses on [KVM](http://libvirt.org/drvqemu.html). Other drivers may not be
working and haven't been tested.
## Example Usage
```hcl
# Configure the Libvirt provider
provider "libvirt" {
uri = "qemu:///system"
}
# Create a new domain
resource "libvirt_domain" "test1" {
...
}
```
## Configuration Reference
The following keys can be used to configure the provider.
* `uri` - (Required) The [connection URI](https://libvirt.org/uri.html) used
to connect to the libvirt host.
## Environment variables
The libvirt connection URI can also be specified with the `LIBVIRT_DEFAULT_URI`
shell environment variable.
```hcl
$ export LIBVIRT_DEFAULT_URI="qemu+ssh://root@192.168.1.100/system"
$ terraform plan
```
|