Skip to main content

Install Chef Infra Client using the migration tool in an airgapped environment

This page documents how to do a fresh install of Chef Infra Client RC2 in an airgapped environment.

Supported platforms

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

Prerequisites

  • a valid Chef License key

Install Chef Infra Client

To install Chef Infra Client, follow these steps:

  1. On an internet-connected machine, download the Chef Infra Client 19 RC2 tar file.

    Chef Infra Client is available in a zipped tar file using a pre-signed URL from an S3 bucket until August 26, 2025.

    Download using curl:

    curl -o chef-chef-infra-client-19.1.rc2.tar.gz https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_tar_folder/chef-chef-infra-client-19.1.rc2.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=Q91HiSIzOxffl52La8EvqSXSqWk%3D&Expires=1756222682

    Download using Wget:

    wget -O "chef-chef-infra-client-19.1.rc2.tar.gz" https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_tar_folder/chef-chef-infra-client-19.1.rc2.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=Q91HiSIzOxffl52La8EvqSXSqWk%3D&Expires=1756222682

  2. On an internet-connected machine, 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 August 26, 2025.

    Using curl:

    curl -o chef-migration-tool.v1.tar.gz https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_migration_tool/migration-tools_Linux_x86_64.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=hbgCCCl9r48WHDP%2FFQtNTN9pFJw%3D&Expires=1756222424

    Using Wget:

    wget -O "chef-migration-tool.v1.tar.gz" https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_migration_tool/migration-tools_Linux_x86_64.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=hbgCCCl9r48WHDP%2FFQtNTN9pFJw%3D&Expires=1756222424

  3. Extract the migration tool and make it executable.

    tar -xvf chef-migration-tool.v1.tar.gz -C /path/to/temp/folder
cd /path/to/temp/folder
chmod +x chef-migrate-cli
mv chef-migrate-cli /usr/local/bin/

  4. Optional: Verify that the migration tool is installed.

    chef-migrate --help

    The migration tool returns available commands and usage guidelines.

  5. Install Chef Infra CLient using chef-migrate apply:

    chef-migrate apply airgap <PATH/TO/BUNDLE> --fresh-install --license-key "<LICENSE_KEY>"

  6. Verify that Chef Infra Client is installed.

    chef-client --version

Next step

Thank you for your feedback!

×