KNIFE-CONFIGURE(1)						    Chef Manual 						KNIFE-CONFIGURE(1)

NAME

       knife-configure - Generate configuration files for knife or Chef Client

SYNOPSIS

       knife configure [client] (options)

DESCRIPTION

       Generates a knife.rb configuration file interactively. When given the --initial option, also creates a new administrative user.

CONFIGURE SUBCOMMANDS

       knife configure (options)

       -i, --initial
	      Create an initial API Client

       -r, --repository REPO
	      The path to your chef-repo

       Create  a configuration file for knife. This will prompt for values to enter into the file. Default values are listed in square brackets if
       no other entry is typed. See knife(1) for a description of configuration options.

       knife configure client directory

       Read the knife.rb config file and generate a config file suitable for use in /etc/chef/client.rb and copy the validation  certificate  into
       the specified directory.

EXAMPLES

       o   On  a  freshly  installed  Chef Server, use knife configure -i to create an administrator and knife configuration file. Leave the field
	   blank to accept the default value. On most systems, the default values are acceptable.

	   user@host$ knife configure -i
	   Please enter the chef server URL: [http://localhost:4000]
	   Please enter a clientname for the new client: [username]
	   Please enter the existing admin clientname: [chef-webui]
	   Please enter the location of the existing admin client's private key: [/etc/chef/webui.pem]
	   Please enter the validation clientname: [chef-validator]
	   Please enter the location of the validation key: [/etc/chef/validation.pem]
	   Please enter the path to a chef repository (or leave blank):
	   Creating initial API user...
	   Created (or updated) client[username]
	   Configuration file written to /home/username/.chef/knife.rb

	   This creates a new administrator client named username, writes a configuration file to /home/username/.chef/knife.rb, and  the  private
	   key to /home/username/.chef/username.pem. The configuration file and private key may be copied to another system to facilitate adminis-
	   tration of the Chef Server from a remote system. Depending on the value given for the Chef Server URL, you may need to modify that set-
	   ting after copying to a remote host.

SEE ALSO

       knife(1) knife-client(1)

AUTHOR

       Chef was written by Adam Jacob adam@opscode.com with many contributions from the community.

DOCUMENTATION

       This  manual  page was written by Joshua Timberman joshua@opscode.com. Permission is granted to copy, distribute and / or modify this docu-
       ment under the terms of the Apache 2.0 License.

CHEF

       Knife is distributed with Chef. http://wiki.opscode.com/display/chef/Home

Chef 10.12.0							     June 2012							KNIFE-CONFIGURE(1)