VirtualBox provider for Terraform in progress
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit ahead, 5 commits behind terra-farm:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Update image location to vagrantcloud Mar 31, 2018
provider add boot_order attr Feb 20, 2018
.gitattibutes Add dependency version management using dep Jul 3, 2018
.gitignore Add dependency version management using dep Jul 3, 2018
.travis.yml Add dependency version management using dep Jul 3, 2018 new vesrion with support for using external links with box format May 22, 2017
Gopkg.lock Add manual override for Jul 13, 2018
Gopkg.toml Add manual override for Jul 13, 2018
LICENSE Create MIT License file Jun 29, 2016
codecov.yml add codecov Nov 7, 2017
main.go Source files updated to reflect the migration to the terra-farm githu… Mar 10, 2018
main_test.go add codecov Nov 7, 2017

Build Status FOSSA Status

VirtualBox provider for Terraform

Inspired by terraform-provider-vix

Donated to the terra-farm group by ccll

How to install

  1. go get

How to build from source

  1. git clone
  2. cd terraform-provider-virtualbox
  3. dep ensure
  4. mv terraform-provider-virtualbox example/
  5. cd example/
  6. terraform plan
  7. terraform apply




  • name, string, required: The name of the virtual machine.
  • image, string, required: The place of the image file(archive or vagrant box).
  • url, string, optional, default not set: The url for downloaded vagrant box from external resource (ex. Ubuntu Vagrant box) . If not set using image variable.
  • cpus, int, optional, default=2: The number of CPUs.
  • memory, string, optional, default="512mib": The size of memory, allow human friendly units like 'MB', 'MiB'.
  • user_data, string, optional, default="": User defined data.
  • status, string, optional, default="running": The status of the VM, allowed values: 'poweroff', 'running'. This value will be updated at runtime to reflect the real status of the VM, and you can also specify it explicitly in config to manually control the status of the VM. This value defaults to 'running', so terraform apply will always try to keep the VM running if not specified otherwise.
  • network_adapter, list: The network adapters in the VM, you can have up to 4 adapters.
    • .#.type, string, requried: The type of the network, allowed values: 'nat', 'bridged', 'hostonly', 'internal', 'generic'.
    • .#.device, string, optional, default="IntelPro1000MTServer": The model of the virtual hardware device, allowed values: 'PCIII', 'FASTIII', 'IntelPro1000MTDesktop', 'IntelPro1000TServer', 'IntelPro1000MTServer'.
    • .#.host_interface, string, optional: Some network type (hostonly, bridged, etc) must bind to a host interface to work properly, use this field to specify the name of the host interface you like to bind to (like 'en0', 'eth1', 'wlan', etc). This should get an improvement, see TODO section below.
    • .#.status, string, computed: The status of the network adapter, possible values: 'up', 'down'.
    • .#.mac_address, string, computed: The MAC address of the adapter, this is generated by VirtualBox.
    • .#.ipv4_address, string, computed: The IPv4 address assigned to the adapter.
    • .#.ipv4_address_available, string, computed: Wheather or not an IPv4 address is actaully assigned to the adapter, possible values: "yes", "no".
  • optical_disks, list: The iso image to attach.

Network adapter types

  • NAT
  • bridged


resource "virtualbox_vm" "node" {
    count = 2
    name = "${format("node-%02d", count.index+1)}"

    image = "~/ubuntu-15.04.tar.xz"
    cpus = 2
    memory = "512mib"

    network_adapter {
        type = "nat"

    network_adapter {
        type = "bridged"
        host_interface = "en0"

    optical_disks = ["./cloudinit.iso"]

output "IPAddr" {
    # Get the IPv4 address of the bridged adapter (the 2nd one) on 'node-02'
    value = "${element(virtualbox_vm.node.*.network_adapter.1.ipv4_address, 1)}"


  • Experimental provider!

Example images


  • Optimize resourceVMUpdate(), eliminate unneccessary restarts of VM.
  • Auto download image from remote url.
  • Validate downloaded image against checksum.
  • Download the same image only once (based on checksum).
  • Re-download corrupted image (based on checksum).


FOSSA Status