Install the Chef DK

[edit on GitHub]

The Chef DK installer is used to set up the Chef development kit on a workstation, including the chef-client itself, an embedded version of Ruby, RubyGems, OpenSSL, key-value stores, parsers, libraries, command line utilities, and community tools such as Kitchen, Berkshelf, and ChefSpec. The Chef installer puts everything into a unique directory (/opt/chefdk/ on macOS / Linux and C:\opscode\chefdk\ on Windows) so that these components will not interfere with other applications that may be running on the target machine.

Note

The Chef installer must run as a root user.

Install

macOS

Note

Apple Xcode is required to install the Chef DK on macOS. Install Xcode via the Mac App Store.

  1. Visit the Chef DK downloads page and select the appropriate package for your macOS version. Click on the Download button.
  2. Follow the steps to accept the license and install the Chef development kit. You will have the option to change your install location; by default the installer uses the /opt/chefdk/ directory.

Windows

  1. Visit the Chef DK downloads page and select the appropriate package for your Windows version. Click on the Download button.
  2. Follow the steps to accept the license and install the Chef development kit. You will have the option to change your install location; by default the installer uses the C:\opscode\chefdk\ directory.
  3. Optional: Set the default shell. On Microsoft Windows it is strongly recommended to use Windows PowerShell and cmd.exe.

See the Chef DK on Windows guide for additional caveats and configuration options specific to Windows.

Linux

  1. Visit the Chef DK downloads page and download the appropriate package for your distribution:

    wget https://packages.chef.io/files/stable/chefdk/2.4.17/ubuntu/16.04/chefdk_2.4.17-1_amd64.deb
    
  2. Use your distribution’s package manager to install the Chef Development Kit:

    • Red Hat Enterprise Linux:

      rpm -Uvh chefdk-2.4.17-1.el7.x86_64.rpm
      
    • Debian/Ubuntu:

      dpkg -i chefdk_2.4.17-1_amd64.deb
      

Next Steps

Now that you’ve installed the Chef DK, proceed to the ChefDk Setup guide to configure your ChefDK installation.