diff --git a/content/workstation/26.1/tools/ctl_chef.md b/content/workstation/26.1/tools/ctl_chef.md index 8694569ca..bfb30730e 100644 --- a/content/workstation/26.1/tools/ctl_chef.md +++ b/content/workstation/26.1/tools/ctl_chef.md @@ -16,7 +16,7 @@ The `chef` executable is a command-line tool that does the following: - Generates repositories, cookbooks, recipes, attributes, templates, and custom resources. - Installs gems into the Chef development environment's Ruby installation. -- Helps you manage your [Policyfiles](/client/latest/policy/policyfile/). Please refer the Policyfile commands [section](#policyfile-commands). +- Helps you manage your [Policyfiles](/client/latest/policy/policyfile/). Refer to the Policyfile commands [section](#policyfile-commands). {{< note >}} @@ -31,7 +31,7 @@ To use a different cache location, set the `CHEF_WORKSTATION_HOME` environment v ## chef capture -The Chef Workstation 26 no longer support `chef capture` command. +Chef Workstation 26 no longer supports the `chef capture` command. ## chef env @@ -87,12 +87,22 @@ None. ## chef gem The `chef gem` subcommand is a wrapper around the `gem` command in -RubyGems and is used by Chef to install RubyGems into Chef Workstation +RubyGems and is used by Chef to install RubyGems into the Chef Workstation development environment. All knife plugins, drivers for Kitchen, and other Ruby applications that aren't packaged within Chef Workstation -will be installed to the `.Chef Workstation` path in the home directory: -`~/.Chef Workstation/gem/ruby/version#/bin` (where `version#` is the -version of Ruby that's packaged within Chef Workstation). +are stored in `~/.chef/ruby/version#/bin` and persist across Chef Workstation upgrades and downgrades. + +### Premium gems + +Chef Workstation can install premium gems from the Chef Premium RubyGem server at rubygems.chef.io. When you run a `chef gem` command, for example `chef gem install premium-gem`, Chef Workstation automatically checks whether rubygems.chef.io is already configured and, if not, attempts to add it. + +If you don't configure a gem source for Chef premium gems, you can't install them. + +{{< note >}} + +The `chef gem` command never prompts interactively for a license key. To configure a license key, run `chef license add` first. + +{{< /note >}} ### Syntax