1. Packages
  2. Libvirt Provider
libvirt 0.8.1 published on Friday, Feb 7, 2025 by dmacvicar

Libvirt Provider

libvirt logo
libvirt 0.8.1 published on Friday, Feb 7, 2025 by dmacvicar

    Generate Provider

    The Libvirt provider must be installed as a Local Package by following the instructions for Any Terraform Provider:

    pulumi package add terraform-provider dmacvicar/libvirt
    

    Overview

    The Libvirt provider is used to interact with Linux libvirt 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. Other drivers may not be working and haven’t been tested.

    The connection URI

    The provider understands connection URIs. The supported transports are:

    • tcp (non-encrypted connection)
    • unix (UNIX domain socket)
    • tls (See here for information how to setup certificates)
    • ssh (Secure shell)

    Unlike the original libvirt, the ssh transport is not implemented using the ssh command and therefore does not require nc (netcat) on the server side.

    Additionally, the ssh URI supports passwords using the driver+ssh://[username:PASSWORD@][hostname][:port]/[path]?sshauth=ssh-password syntax.

    As the provider does not use libvirt on the client side, not all connection URI options are supported or apply.

    Configuration Reference

    The following keys can be used to configure the provider.

    • uri - (Required) The connection URI 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.

    libvirt logo
    libvirt 0.8.1 published on Friday, Feb 7, 2025 by dmacvicar