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:

Channel	Description
`stable`	A build from this channel is an “official” release that has passed full user acceptance testing. Artifacts in this channel are retained indefinitely.
`current`	A build from this channel is an “integration” build that has passed full testing, but hasn’t been officially released. Artifacts in this channel are retained for 30 days and then removed automatically.

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:

Enable APT to fetch packages over HTTPS:

sudo apt-get install apt-transport-https

Install the public key for Chef Software:

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

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

Update the package repository list:

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

Update the cache for the package repository:
```
sudo apt-get update
```

Enterprise Linux

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

Install the public key for Chef Software:

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

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.

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 isn’t 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/
```