.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "KNIFE\-COOKBOOK\-SITE" "1" "April 2011" "Chef 0.10.0.beta.8" "Chef Manual"
.
.SH "NAME"
\fBknife\-cookbook\-site\fR \- Install and update open source cookbooks
.
.SH "SYNOPSIS"
\fBknife\fR \fBcookbook site\fR \fIsub\-command\fR \fI(options)\fR
.
.SH "COOKBOOK SITE SUB\-COMMANDS"
The following sub\-commands are still in the context of cookbooks, but they make use of Opscode\'s Cookbook Community site, \fIhttp://cookbooks\.opscode\.com/\fR\. That site has an API, and these sub\-commands utilize that API, rather than the Chef Server API\.
.
.P
\fBcookbook site download COOKBOOK [VERSION]\fR \fI(options)\fR
.
.TP
\fB\-f\fR, \fB\-\-file FILE\fR
The filename to write to
.
.P
Downloads a specific cookbook from the Community site, optionally specifying a certain version\.
.
.P
\fBcookbook site list\fR \fI(options)\fR
.
.TP
\fB\-w\fR, \fB\-\-with\-uri\fR
Show corresponding URIs
.
.P
Lists available cookbooks from the Community site\.
.
.P
\fBcookbook site search QUERY\fR \fI(options)\fR
.
.P
Searches the Community site with the specified query\.
.
.P
\fBcookbook site share COOKBOOK CATEGORY\fR \fI(options)\fR
.
.TP
\fB\-k\fR, \fB\-\-key KEY\fR
API Client Key
.
.TP
\fB\-u\fR, \fB\-\-user USER\fR
API Client Username
.
.TP
\fB\-o\fR, \fB\-\-cookbook\-path PATH:PATH\fR
A colon\-separated path to look for cookbooks in
.
.P
Uploads the specified cookbook using the given category to the Opscode cookbooks site\. Requires a login user and certificate for the Opscode Cookbooks site\. See \fBEXAMPLES\fR for usage if the Opscode user and certificate pair are not used for authenticating with the Chef Server\. In other words, if the Chef Server is not the Opscode Platform\.
.
.P
\fBcookbook site unshare COOKBOOK\fR
.
.P
Stops sharing the specified cookbook on the Opscode cookbooks site\.
.
.P
\fBcookbook site show COOKBOOK [VERSION]\fR \fI(options)\fR
.
.P
Shows information from the site about a particular cookbook\.
.
.P
\fBcookbook site vendor COOKBOOK [VERSION]\fR \fI(options)\fR
.
.TP
\fB\-d\fR, \fB\-\-dependencies\fR
Grab dependencies automatically
.
.P
Uses \fBgit\fR version control in conjunction with the cookbook site to download upstream cookbooks\. A new vendor branch is created in git, the cookbook downloaded from the site and untarred, then the master branch is merged\. This allows the user to track upstream changes to cookbooks while merging in customizations\. If \fI\-d\fR is specified, all the cookbooks it depends on (via metadata \fIdependencies\fR) are downloaded and untarred as well, each using their own vendor branch\.
.
.SH "SEE ALSO"
\fBknife\-environment\fR(1)
.
.SH "AUTHOR"
Chef was written by Adam Jacob \fIadam@opscode\.com\fR with many contributions from the community\.
.
.SH "DOCUMENTATION"
This manual page was written by Joshua Timberman \fIjoshua@opscode\.com\fR\. Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2\.0 License\.
.
.SH "CHEF"
Knife is distributed with Chef\. \fIhttp://wiki\.opscode\.com/display/chef/Home\fR