» Vagrant Settings

Config namespace: config.vagrant

The settings within config.vagrant modify the behavior of Vagrantitself.

» Available Settings

  • config.vagrant.host (string, symbol) - This sets the type of host machinethat is running Vagrant. By default this is :detect, which causes Vagrant toauto-detect the host. Vagrant needs to know this information in order to performsome host-specific things, such as preparing NFS folders if they're enabled.You should only manually set this if auto-detection fails.

  • config.vagrant.plugins - (string, array, hash) - Define plugin, list ofplugins, or definition of plugins to install for the local project. Vagrantwill require these plugins be installed and available for the project. Ifthe plugins are not available, it will attempt to automatically installthem into the local project. When requiring a single plugin, a string canbe provided:

  1. config.vagrant.plugins = "vagrant-plugin"

If multiple plugins are required, they can be provided as an array:

  1. config.vagrant.plugins = ["vagrant-plugin", "vagrant-other-plugin"]

Plugins can also be defined as a Hash, which supports setting extra optionsfor the plugins. When a Hash is used, the key is the name of the plugin, andthe value is a Hash of options for the plugin. For example, to set an explicitversion of a plugin to install:

  1. config.vagrant.plugins = {"vagrant-scp" => {"version" => "1.0.0"}}

Supported options are:

  • entry_point - Path for Vagrant to load plugin
  • sources - Custom sources for downloading plugin
  • version - Version constraint for plugin
    • config.vagrant.sensitive - (string, array) - Value or list of values thatshould not be displayed in Vagrant's output. Value(s) will be removed fromVagrant's normal UI output as well as logger output.
  1. config.vagrant.sensitive = ["MySecretPassword", ENV["MY_TOKEN"]]