vagrant/website/docs/source/v2/provisioning/chef_common.html.md

page_title	sidebar_current
Common Chef Options - Provisioning	provisioning-chefcommon

Shared Chef Options

This page documents the list of available options that are available in the Chef Solo, Chef Zero and Chef Client provisioners.

• arguments (string) - A list of additional arguments to pass on the command-line to Chef. Since these are passed in a shell-like environment, be sure to properly quote and escape characters if necessary. By default, no additional arguments are sent.

• attempts (int) - The number of times Chef will be run if an error occurs. This defaults to 1. This can be increased to a higher number if your Chef runs take multiple runs to reach convergence.

• binary_path (string) - The path to the directory of the Chef executable binaries. By default, Vagrant looks for the proper Chef binary on the PATH.

• custom_config_path (string) - A path to a custom Chef configuration local on your machine that will be used as the Chef configuration. This Chef configuration will be loaded after the Chef configuration that Vagrant generates, allowing you to override anything that Vagrant does. This is also a great way to use new Chef features that may not be supported fully by Vagrant's abstractions yet.

• encrypted_data_bag_secret_key_path (string) - The path to the secret key file to decrypt encrypted data bags. By default, this is not set.

• environment (string) - The environment you want the Chef run to be a part of.

• formatter (string) - The formatter to use for output from Chef.

• http_proxy, http_proxy_user, http_proxy_pass, no_proxy (string) - Settings to configure HTTP and HTTPS proxies to use from Chef. These settings are also available with http replaced with https to configure HTTPS proxies.

• json (hash) - Custom node attributes to pass into the Chef run.

• log_level (string) - The log level for Chef output. This defaults to "info".

• node_name (string) - The node name for the Chef Client. By default this will be your hostname.

• provisioning_path (string) - The path on the remote machine where Vagrant will store all necessary files for provisioning such as cookbooks, configurations, etc. This path must be world writable. By default this is /tmp/vagrant-chef-# where "#" is replaced by a unique counter.

• run_list (array) - The run list that will be executed on the node.

• file_cache_path and file_backup_path (string) - Paths on the remote machine where files will be cached and backed up. It is useful sometimes to configure this to a synced folder address so that this can be shared across many Vagrant runs.

• verbose_logging (boolean) - Whether or not to enable the Chef verbose_logging option. By default this is false.