Merge 837dff00b8 into b231abe114

plugins/providers/virtualbox/action/network.rb

@@ -248,6 +248,7 @@ module VagrantPlugins
         def hostonly_config(options)
           options = {
             auto_config: true,
+            dhcp_server: true,
             mac:         nil,
             nic_type:    nil,
             type:        :static,
@@ -320,6 +321,7 @@ module VagrantPlugins
           return {
             adapter_ip:  options[:adapter_ip],
             auto_config: options[:auto_config],
+            dhcp_server: options[:dhcp_server],
             ip:          options[:ip],
             mac:         options[:mac],
             name:        options[:name],
@@ -347,7 +349,7 @@ module VagrantPlugins
             @logger.info("Created network: #{interface[:name]}")
           end
 
-          if config[:type] == :dhcp
+          if config[:type] == :dhcp && config[:dhcp_server]
             create_dhcp_server_if_necessary(interface, config)
           end
 

test/unit/plugins/providers/virtualbox/action/network_test.rb

@@ -123,6 +123,7 @@ describe VagrantPlugins::ProviderVirtualBox::Action::Network do
         dhcp_ip: "172.28.128.2",
         dhcp_lower: "172.28.128.3",
         dhcp_upper: "172.28.128.254",
+        dhcp_server: true,
         adapter: 2
       })
 

website/source/docs/virtualbox/networking.html.md

@@ -39,6 +39,33 @@ Vagrant.configure("2") do |config|
 end
 ```
 
+## VirtualBox Host DHCP Server
+
+By default, when specifying a `private_network` with a type of `dhcp` the
+Vagrant VirtualBox provider will attempt to find or create an appropriate
+host-only network. If the network does not have a DHCP server configured the
+provider will attempt to provision one. Sometimes this feature is undesirable.
+For example, perhaps resolving dynamic DNS records between guests sharing
+a private network is required. The DHCP server built into VirtualBox does
+not support dynamic DNS resolution so an alternative is needed.
+
+<div class="alert alert-warning">
+  <strong>Advanced topic!</strong> This is a reasonably advanced topic that
+  requires configuration outside of Vagrant. The example below requires
+  a DHCP server or relay configured outside of VirtualBox responds to
+  requests on the designated host-only network.
+</div>
+
+To override the default behavior and prevent the Vagrant VirtualBox
+provider from creating a DHCP server for the defined host-only network:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.network "private_network", type: "dhcp", name: "vboxnet0",
+    virtualbox__dhcp_server: false
+end
+```
+
 ## VirtualBox NIC Type
 
 You can specify a specific NIC type for the created network interface