Install Chef Infra Client

This page documents how to do a clean install of Chef Infra Client RC1 using the Chef Infra Client migration tool on a system that doesn’t have a previous version of Chef Infra Client installed.

To upgrade to Chef Infra Client 19 RC1 from an earlier major version, see the upgrade documentation.

Supported platforms

Chef Infra Client 19 RC1 is supported on Linux x86-64 systems.

Prerequisites

a valid Chef license key

Install Chef Infra Client

Optional: Verify that Chef Infra Client isn’t already installed on your system:
```
chef-client --version
```

Download the Chef Infra Client migration tool.

The migration tool is available for download as a zipped tar file using a pre-signed URL from an S3 bucket until May 22, 2025.

Using curl:

curl -o chef-migration-tool.v1.tar.gz https://chef-hab-migration-tool-bucket.s3.amazonaws.com/migration-tools_Linux_x86_64.tar.gz\?AWSAccessKeyId\=AKIAW4FPVFT6LUYZUYOB\&Signature\=2P3xjN53%2Bib%2BnZBqFk5%2FsEORUzI%3D\&Expires\=1747912109

Using Wget:

wget -O "chef-migration-tool.v1.tar.gz" https://chef-hab-migration-tool-bucket.s3.amazonaws.com/migration-tools_Linux_x86_64.tar.gz\?AWSAccessKeyId\=AKIAW4FPVFT6LUYZUYOB\&Signature\=2P3xjN53%2Bib%2BnZBqFk5%2FsEORUzI%3D\&Expires\=1747912109

Extract the migration tool in a temporary directory.
Use the -C flag select a directory to unzip and un-tar the files.
```
tar -xvf chef-migration-tool.v1.tar.gz -C /path/to/folder
```
Optional: Verify that the migration tool is installed.
```
cd /path/to/folder
./chef-migrate --help
```
The migration tool returns available commands and usage guidelines.
Install Chef Infra Client RC1 with the migration tool using the apply online command.
```
sudo ./chef-migrate apply online --fresh_install --preserve true --download.url "https://unstable-habitat-tarball.s3.amazonaws.com/chef-chef-infra-client-19.0.54-20241121145703.tar.gz?AWSAccessKeyId=AKIA2L25YRBIC3WVJTRM&Signature=Kp6oGpPRqwiNEhKh8UWlUPJZ6DU%3D&Expires=1747912507" --license.key <VALID_LICENSE_KEY>
```
Replace <VALID_LICENSE_KEY> with a valid license key.
The migration tool validates your Chef license, downloads Chef Infra Client from the specified download URL, and installs Chef Infra Client. The Chef Infra Client RC1 package is available for download as a zipped tar file from this pre-signed URL until May 22, 2025.
Note
Use the --debug CLI option to get additional information about the install process.
Logs are available in /var/log/chef19migrate.log.
Verify that Chef Infra Client 19 RC1 is installed:
```
chef-client --version
```
It returns version number 19.0.54 or greater.
You can also verify that Chef Infra Client is installed by finding it in the /hab/pkgs/chef/chef-infra-client/19.0.54 directory.

Next step

Add a Chef license to Chef Infra Client.