VirtualBox provider for Terraform

Published documentation is located on the Terraform Registry

Maintainers Needed

We are looking for additional maintainers.

Usage

You can use the following image in order to avoid timeouts during terraform plan "timeout while waiting for state to become 'yes' (timeout: 5m0s)": https://github.com/ccll/terraform-provider-virtualbox-images/releases

Or download a Vagrant box locally :

ex : https://app.vagrantup.com/generic/boxes/debian10/versions/4.2.10

Here is a working .tf example file:

terraform {
  required_providers {
    virtualbox = {
      source = "terra-farm/virtualbox"
      version = "0.2.2-alpha.1"
    }
  }
}

# There are currently no configuration options for the provider itself.

resource "virtualbox_vm" "node" {
  count     = 1
  name      = "ubuntu"
  image     = "ubuntu-15.04.tar.xz"
  cpus      = 2
  memory    = "512 mib"
  #user_data = file("${path.module}/user_data")

  network_adapter {
    type           = "bridged"
    host_interface = "enp2s0"
  }
}

output "IPAddr" {
  value = element(virtualbox_vm.node.*.network_adapter.0.ipv4_address, 1)
}

Example

You can find a practical example in the /examples directory

If you want to contribute documentation changes, see the Contribution guide.

Limitations

• Experimental provider!
• We only officially support the latest version of Go, Virtualbox and Terraform. The provider might be compatible and work with other versions but we do not provide any level of support for this due to lack of time.
• The defaults here are only tested with the vagrant insecure (packer) keys as the login.

Contributors

Special thanks to all contributors, and @ccll for donating the original project to the terra-farm group!

Inspired by terraform-provider-vix

License