A new platform for documentation and tutorials is launching soon.
We are migrating Vagrant documentation into HashiCorp Developer, our new developer experience.
The VirtualBox provider exposes some additional configuration options that allow you to more finely control your VirtualBox-powered Vagrant environments.
GUI vs. Headless
By default, VirtualBox machines are started in headless mode, meaning there is no UI for the machines visible on the host machine. Sometimes, you want to have a UI. Common use cases include wanting to see a browser that may be running in the machine, or debugging a strange boot issue. You can easily tell the VirtualBox provider to boot with a GUI:
config.vm.provider "virtualbox" do |v| v.gui = true end
Virtual Machine Name
You can customize the name that appears in the VirtualBox GUI by
name property. By default, Vagrant sets it to the containing
folder of the Vagrantfile plus a timestamp of when the machine was created.
By setting another name, your VM can be more easily identified.
config.vm.provider "virtualbox" do |v| v.name = "my_vm" end
Default NIC Type
By default Vagrant will not set the NIC type for network interfaces. This
allows VirtualBox to apply the default NIC type for the guest. If you would
like to use a specific NIC type by default for guests, set the
config.vm.provider "virtualbox" do |v| v.default_nic_type = "82543GC" end
By default new machines are created by importing the base box. For large boxes this produces a large overhead in terms of time (the import operation) and space (the new machine contains a copy of the base box's image). Using linked clones can drastically reduce this overhead.
Linked clones are based on a master VM, which is generated by importing the base box only once the first time it is required. For the linked clones only differencing disk images are created where the parent disk image belongs to the master VM.
config.vm.provider "virtualbox" do |v| v.linked_clone = true end
To have backward compatibility:
config.vm.provider "virtualbox" do |v| v.linked_clone = true if Gem::Version.new(Vagrant::VERSION) >= Gem::Version.new('1.8.0') end
If you do not want backward compatibility and want to force users to
support linked cloning, you can use
Vagrant.require_version with 1.8.
Note: the generated master VMs are currently not removed automatically by Vagrant. This has to be done manually. However, a master VM can only be removed when there are no linked clones connected to it.
Checking for Guest Additions
By default Vagrant will check for the VirtualBox Guest
Additions when starting a
machine, and will output a warning if the guest additions are missing or
out-of-date. You can skip the guest additions check by setting the
config.vm.provider "virtualbox" do |v| v.check_guest_additions = false end
VBoxManage is a utility that can be used to make modifications to VirtualBox virtual machines from the command line.
Vagrant exposes a way to call any command against VBoxManage just prior to booting the machine:
config.vm.provider "virtualbox" do |v| v.customize ["modifyvm", :id, "--cpuexecutioncap", "50"] end
In the example above, the VM is modified to have a host CPU execution cap of 50%, meaning that no matter how much CPU is used in the VM, no more than 50% would be used on your own host machine. Some details:
:idspecial parameter is replaced with the ID of the virtual machine being created, so when a VBoxManage command requires an ID, you can pass this special parameter.
customizedirectives can be used. They will be executed in the order given.
There are some convenience shortcuts for memory and CPU settings:
config.vm.provider "virtualbox" do |v| v.memory = 1024 v.cpus = 2 end