Chef Software Packages

You can install packages for Chef Software products using platform-native package repositories.

Release channels

Chef releases packages from the following release channels:

Use the stable channel when installing Chef products on production systems.

Package repositories

The stable and current release channels support the following package repositories:

• APT (Debian and Ubuntu platforms)
• Yum (Enterprise Linux platforms)

You can download Chef Software’s GPG public key from packages.chef.io.

Debian / Ubuntu

To set up an APT package repository for Debian and Ubuntu platforms:

1. Enable APT to fetch packages over HTTPS:

   sudo apt-get install apt-transport-https
   

2. Install the public key for Chef Software:

   wget -qO - https://packages.chef.io/chef.asc | sudo apt-key add -
   

3. Create the APT repository source file:

   echo "deb https://packages.chef.io/repos/apt/<CHANNEL> <DISTRIBUTION> main" > chef-<CHANNEL>.list
   

   Replace:

   • <CHANNEL> with the release channel: stable or current.

   • <DISTRIBUTION> with the appropriate distribution name. For example:

     • for Debian 9: stretch
     • for Debian 10: buster
     • for Debian 11: bullseye
     • for Ubuntu 18.04: bionic
     • for Ubuntu 20.04: focal

4. Update the package repository list:

   sudo mv chef-stable.list /etc/apt/sources.list.d/
   

5. Update the cache for the package repository:

   sudo apt-get update
   

Enterprise Linux

To set up a Yum package repository for Enterprise Linux platforms:

1. Install the public key for Chef Software:

   sudo rpm --import https://packages.chef.io/chef.asc
   

2. Create the Yum repository source file:

   cat >chef-<CHANNEL>.repo <<EOL
   [chef-<CHANNEL>]
   name=chef-<CHANNEL>
   baseurl=https://packages.chef.io/repos/yum/<CHANNEL>/el/<VERSION>/\$basearch/
   gpgcheck=1
   # No auto-upgrade, as there are manual steps needed for Chef Infra Server upgrades
   enabled=0
   EOL
   

   Replace:

   • <CHANNEL> with the release channel: stable or current.
   • <VERSION> with the version Enterprise Linux version.

3. Update the package repository list:

   sudo yum-config-manager --add-repo chef-stable.repo
   

   Note that the yum-config-manager command requires the yum-utils package, which is not installed on CentOS by default. You can install the package by running sudo yum install yum-utils, or you can use the mv command to add the repository to the /etc/yum.repos.d/ directory:

   sudo mv chef-stable.repo /etc/yum.repos.d/