Chef InSpec install guide

Chef InSpec 7 installers are available for Windows, Debian, RPM-based Linux distributions, and macOS. You can download and install pre-built .msi, .deb, .rpm, or .dmg packages using your existing package management tools.

Supported platforms

Chef InSpec is supported on the following platforms:

Windows x86-64
Linux x86-64
macOS Apple Silicon (ARM-64)

Prerequisites

This installation process has the following prerequisites:

Chef InSpec, Chef Automate, and Chef Workstation aren’t installed on the target system.
If Chef InSpec is already installed, see the Chef InSpec uninstall documentation.
On Windows systems, tar is installed.
On Debian-based systems, the dpkg package manager is installed.
On RPM-based systems, rpm and either dnf or yum are installed. For Amazon Linux 2, use rpm and yum.
On macOS systems, you have administrator access to run the installer command.
You have a valid Progress Chef license key.
The target system is connected to the internet.

Install Chef InSpec

Install Chef InSpec on Debian-based systems

To install Chef InSpec on a Debian-based system, follow these steps:

Download the Debian-based installer using one of the following methods:

Download using wget:

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

Download using curl:

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

Replace:

<VERSION> with the version number to install.
<LICENSE_ID> with your Chef license ID.

Install Chef InSpec:
```
sudo dpkg -i inspec-enterprise-<VERSION>_amd64.deb
```
Replace <VERSION> with the version number of the downloaded package, for example inspec-enterprise-7.1.6-1_amd64.deb.
Verify that Chef InSpec is installed:
```
inspec version
```
The output displays the installed Chef InSpec version.
Accept the Chef EULA.

Install Chef InSpec on RPM-based systems

To install Chef InSpec on an RPM-based system, follow these steps:

Download the RPM-based installer using one of the following methods:

Download using wget:

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

Download using curl:

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

Replace:

<VERSION> with the version number to install.
<LICENSE_ID> with your Chef license ID.

Install Chef InSpec using one of the following methods:
- Install using rpm:
```
sudo rpm -Uvh inspec-enterprise-<VERSION>.x86_64.rpm
```
- Install using dnf:
```
sudo dnf install ./inspec-enterprise-<VERSION>.x86_64.rpm
```
- For Amazon Linux 2 or systems using yum:
```
sudo yum install ./inspec-enterprise-<VERSION>.x86_64.rpm
```
Replace <VERSION> with the version number of the downloaded package, for example inspec-enterprise-7.1.6-1.amzn2.x86_64.rpm.
Verify that Chef InSpec is installed:
```
inspec version
```
The output displays the installed Chef InSpec version.
Accept the Chef EULA.

Install Chef InSpec on Windows

To install Chef InSpec on Windows, follow these steps:

Download the installer in an elevated PowerShell session:

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

Install Chef InSpec using one of the following methods:
- Run the following command in an elevated PowerShell or Command Prompt session:
```
msiexec /i inspec-enterprise-<VERSION>-x64.msi /qn
```
  Replace <VERSION> with the version number of the downloaded package, for example inspec-enterprise-7.1.6-1_x64.msi.
- Double-click the .msi file and follow the on-screen installation wizard.
Verify that Chef InSpec is installed:
```
inspec version
```
The output displays the installed Chef InSpec version.
Accept the Chef EULA.

Install Chef InSpec on macOS

Chef InSpec supports macOS on Apple Silicon (ARM-64) devices.

To install Chef InSpec on macOS, follow these steps:

Download the macOS installer using one of the following methods:

Download using wget:

wget -O "inspec-enterprise-<VERSION>-macos.dmg" "https://chefdownload-commercial.chef.io/stable/inspec/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=mac_os_x&pm=dmg&v=<VERSION>"

Download using curl:

curl -o "inspec-enterprise-<VERSION>-macos.dmg" "https://chefdownload-commercial.chef.io/stable/inspec/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=mac_os_x&pm=dmg&v=<VERSION>"

Replace:

<VERSION> with the version number to install.
<LICENSE_ID> with your Chef license ID.

Mount the disk image:
```
hdiutil attach inspec-enterprise-<VERSION>-macos.dmg
```
This command mounts the .dmg file as a volume that appears in Finder.
Install Chef InSpec from the mounted volume, using one of the following methods:
- In Finder, open the mounted volume, double-click the .pkg file, and follow the on-screen installation wizard.
- Install using the installer command:
```
sudo installer -pkg "/Volumes/<MOUNTED_VOLUME_NAME>/inspec-enterprise-<VERSION>.pkg" -target /
```
  Replace the following:
  - <MOUNTED_VOLUME_NAME> with the name of the mounted .dmg volume.
  - <VERSION> with the version number of the downloaded package, for example 7.1.16.

Unmount the disk image:

hdiutil detach "/Volumes/<MOUNTED_VOLUME_NAME>"

Verify that Chef InSpec is installed:
```
inspec version
```
The output displays the installed Chef InSpec version.
Accept the Chef EULA.

Upgrade Chef InSpec

To upgrade Chef InSpec to a newer version:

Uninstall the current version using the steps for your platform.
Download and install the new version using the steps for your platform using the instruction on this page.

More information

Chef Download API documentation