Install Chef Infra Client with a native installer

The Chef Infra Client native installers provide an efficient way to install Chef Infra Client on Windows, Debian, or RPM-based Linux distributions. You can download and install the pre-built .msi, .deb, or .rpm packages using your existing package management tools, simplifying the deployment process for managing system configurations.

Supported platforms

Chef Infra Client is supported on:

Currently supported Linux distributions and versions running Linux kernel 2.6.32 and later on x86-64 (amd64) and ARM (aarch64) architectures
Currently supported Windows versions greater than or equal to Windows 10 and Windows Server 2016

Prerequisites

This installation process has the following prerequisites:

Chef Workstation isn’t installed on the target system.
On Debian-based systems, the dpkg package manager is installed on the target system.
On RPM-based systems, the RPM and either the DNF or Yum package managers are installed on the target system.
For Amazon Linux 2, use the RPM and Yum package managers.
You have a valid Progress Chef license key.
The target system is connected to the internet.

Install Chef Infra Client

To install Chef Infra Client , follow these steps:

Download the Chef Infra Client installer.

Download Debian-based installer

For Debian-based distributions:

Using Wget:

For x86-64 (amd64):

wget -O "chef-ice-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=deb&v=<VERSION>"

For ARM (aarch64):

wget -O "chef-ice-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=deb&v=<VERSION>"

Using curl:

For x86-64 (amd64):

curl -o "chef-ice-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=deb&v=<VERSION>"

For ARM (aarch64):

curl -o "chef-ice-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=deb&v=<VERSION>"

Download RPM-based installer

For RPM-based distributions:

Using Wget:

For x86-64 (amd64):

wget -O chef-ice-<VERSION>-linux.rpm "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=rpm&v=<VERSION>"

For ARM (aarch64):

wget -O chef-ice-<VERSION>-linux.rpm "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=rpm&v=<VERSION>"

Using curl:

For x86-64 (amd64):

curl -o chef-ice-<VERSION>-linux.rpm "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=rpm&v=<VERSION>"

For ARM (aarch64):

curl -o chef-ice-<VERSION>-linux.rpm "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=rpm&v=<VERSION>"

Download Windows installer

For Windows:

Using curl:

curl -o chef-ice-<VERSION>-windows.msi "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=windows&pm=msi&v=<VERSION>"

Using PowerShell:

Invoke-WebRequest -Uri "https://chefdownload-commercial.chef.io/stable/chef-ice/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=windows&pm=msi&v=<VERSION>" -OutFile "chef-ice-<VERSION>-windows.msi"

Note

For macOS, skip this step. Installing the migration tool and running migrate-ice apply downloads and installs Chef Infra Client in one step. See the Install from tarball section below.

Go to the directory with the installer and install the package.
- Install on Debian-based distributions
  For Debian-based distributions:
```
sudo -E dpkg -i chef-ice-<VERSION>-linux.deb
```
- Install on RPM-based distributions
  For RPM-based distributions:
```
sudo -E dnf install chef-ice-<VERSION>-linux.rpm -y
```
  or:
```
sudo -E rpm -ivh chef-ice-<VERSION>-linux.rpm
```
- Install from tarball
  For macOS, install the migration tool, then download and install Chef Infra Client in one step:
```
.\migrate-ice apply online --fresh-install --download-url "<CHEF_TAR_DOWNLOAD_URL>"
```
- Install on Windows
  Install on Windows:
  - Double-click on the MSI package and install using Windows Package Manager.
  or:
  - Using Powershell:
    msiexec /i "chef-ice-<VERSION>-windows.msi"
Verify the installation:
```
chef-client --version
```

More information

Chef Download API documentation