---
layout: "libvirt"
page_title: "Libvirt: libvirt_volume"
sidebar_current: "docs-libvirt-volume"
description: |-
  Manages a storage volume in libvirt
---

# libvirt\_volume

Manages a storage volume in libvirt. For more information see
[the official documentation](https://libvirt.org/formatstorage.html).

## Example Usage

```hcl
# Base OS image to use to create a cluster of different
# nodes
resource "libvirt_volume" "opensuse_leap" {
  name = "opensuse_leap"
  source = "http://download.opensuse.org/repositories/Cloud:/Images:/Leap_42.1/images/openSUSE-Leap-42.1-OpenStack.x86_64.qcow2"
}

# volume to attach to the "master" domain as main disk
resource "libvirt_volume" "master" {
  name           = "master.qcow2"
  base_volume_id = "${libvirt_volume.opensuse_leap.id}"
}

# volumes to attach to the "workers" domains as main disk
resource "libvirt_volume" "worker" {
  name           = "worker_${count.index}.qcow2"
  base_volume_id = "${libvirt_volume.opensuse_leap.id}"
  count          = "${var.workers_count}"
}
```

~> **Tip:** when provisioning multiple domains using the same base image, create
a `libvirt_volume` for the base image and then define the domain specific ones
as based on it. This way the image will not be modified and no extra disk space
is going to be used for the base image.

## Argument Reference

The following arguments are supported:

* `name` - (Required) A unique name for the resource, required by libvirt.
  Changing this forces a new resource to be created.
* `pool` - (Optional) The storage pool where the resource will be created.
  If not given, the `default` storage pool will be used.
* `source` - (Optional) If specified, the image will be uploaded into libvirt
  storage pool. It's possible to specify the path to a local (relative to the
  machine running the `terraform` command) image or a remote one. Remote images
  have to be specified using HTTP(S) urls for now.
* `size` - (Optional) The size of the volume in bytes (if you don't like this,
  help fix [this issue](https://github.com/hashicorp/terraform/issues/3287).
  If `source` is specified, `size` will be set to the source image file size.
* `base_volume_id` - (Optional) The backing volume (CoW) to use for this volume.
* `base_volume_name` - (Optional) The name of the backing volume (CoW) to use
  for this volume. Note well: when `base_volume_pool` is not specified the
  volume is going to be searched inside of `pool`.
* `base_volume_pool` - (Optional) The name of the storage pool containing the
  volume defined by `base_volume_name`.

## Attributes Reference

* `id` - a unique identifier for the resource