Skip to main content

Supported platforms

Progress Chef software is supported on the operating systems (platforms) listed below. To see which versions of our software we currently support, see the supported versions page.

Support definitions

Refer to the following sections for definitions of the certification tiers, installer types, and agent and agentless modes.

Certification tiers

Validated and supported
These platforms are fully tested on every release. These platforms run through the complete Chef automated test suite in Continuous Integration/Continuous Delivery (CI/CD) prior to each release.
Supported (untested)
These platforms are fully supported, but not tested in our CI/CD pipelines. Chef supports these platforms and will address any reported bugs.
User-reported
These platforms are validated by users. Support is provided on a best-effort basis.

Installer types

Native
Chef is installed using the platform’s native package manager - (Microsoft Installer (MSI)) on Windows, Debian package (DEB) on Debian/Ubuntu, RPM Package Manager (RPM) on Red Hat Enterprise Linux (RHEL)/SUSE, or PKG (macOS installer package).
Habitat
Chef is installed and run using Chef Habitat commands (hab pkg install) or by extracting a Habitat artifact (.hart or .tar.gz). Used for platforms where a native package isn’t available or where a self-contained runtime is preferred.

Agent and agentless modes

Agent-based mode
Agent-based mode includes all software that runs directly on the managed node:
  • Chef Infra Client
  • Chef InSpec
  • Chef Habitat supervisor
  • Chef 360 Platform skills running in agent mode, including Courier job execution and Node Management
Agentless mode
Agentless mode includes all software that manages a node remotely without an agent present on the node:
  • Chef Infra Client agentless mode (formerly Target Mode)—connects using SSH (Linux) or WinRM/SSH (Windows)
  • Chef InSpec (remote scanning)
  • Chef 360 Courier agentless job execution

Chef software is supported on the operating systems (platforms) listed below. To check which versions of our software we currently support, refer to the Supported Versions page.

Platforms

The sections below list the platforms that Chef Software supports.

Chef Automate

Standalone

Chef Automate has the following operating system requirements:

  • A Linux operating system with kernel version 3.2 or later
  • systemd as the init system
  • The useradd command-line utility for creating user accounts
  • Either curl or wget for downloading installation assets

For more information, see the Chef Automate system requirements

Chef Automate HA

Operating SystemSupported Versions
Red Hat Enterprise Linux (64-bit)7, 8, 9
Ubuntu (64-bit)16.04.x, 18.04.x, 20.04.x
CentOS (64-bit)7
Amazon Linux 2 (64-bit)2 (kernel 5.10)
SUSE Linux Enterprise Server12.5
Oracle Linux9

Additional requirements:

  • On RHEL 8 and RHEL 9, SELinux must be configured in permissive mode.

For more information, see the Chef Automate HA system requirements.

Chef Habitat

Chef Habitat 2.1 has the following minimum platform requirements:

PlatformArchitectureSupported Version
Linuxx86_64 (64-bit Intel or AMD)Modern Linux kernels
LinuxARM64 (64-bit)Modern Linux kernels
Windowsx86_64 (64-bit)Windows Server 2012 or later; Windows 8 or later
macOSApple Silicon (ARM64) or Intel (x86_64)macOS 14 or later

Chef Habitat 2.0 has the following minimum platform requirements:

PlatformArchitectureSupported Version
Linuxx86_64 (64-bit)Kernel 2.6.32 or later
LinuxARM64 (64-bit)Modern Linux kernels
Windowsx86_64 (64-bit)Windows Server 2012 or later; Windows 8 or later
macOSx86_64 (64-bit)macOS 10.9 or later

Chef Habitat 1.6 has the following minimum platform requirements:

PlatformArchitectureMinimum Version
Linuxx86_64 (64-bit)Linux kernel 2.6.32 or later
macOSx86_64 (64-bit)macOS 10.9 or later
Windowsx86_64 (64-bit)Windows Server 2012 or later; Windows 8 or later

Chef Infra Client

RHEL/Enterprise Linux family

PlatformArchitectureVersionTierAgentAgentlessInstaller
Red Hat Enterprise Linuxx86_64, aarch648.x, 9.x, 10.xValidated and supportedYesYesNative, Habitat
Red Hat Enterprise Linuxs390x, ppc64le, ppc648.xValidated and supportedNoYesHabitat
Oracle Linuxx86_64, aarch648.x, 9.xValidated and supportedYesYesNative, Habitat
Amazon Linuxx86_64, aarch642023Validated and supportedYesYesNative, Habitat
Rocky Linuxx86_64, aarch648.x, 9.x, 10.xSupported (untested)YesYesHabitat
AlmaLinuxx86_64, aarch648.x, 9.x, 10.xSupported (untested)YesYesHabitat
CentOS Streamx86_64, aarch64current non–End-Of-Life (EOL) releasesUser-reportedYesYesHabitat
Fedorax86_64, aarch64current non-EOL releasesUser-reportedYesYesHabitat

Debian/Ubuntu family

PlatformArchitectureVersionTierAgentAgentlessInstaller
Debianx86_64, aarch6412, 13Validated and supportedYesYesNative, Habitat
Ubuntu (LTS releases)x86_64, aarch6422.04, 24.04, 26.04Validated and supportedYesYesNative, Habitat
Kali Linuxx86_64current non-EOL releasesUser-reportedYesYesHabitat
Linux Mintx86_64current non-EOL releasesUser-reportedYesYesHabitat
Pop!_OSx86_64current non-EOL releasesUser-reportedYesYesHabitat
Raspberry Pi OSaarch64current non-EOL releasesUser-reportedYesYesHabitat
Ubuntu (non-LTS)x86_64, aarch64current non-LTS releasesUser-reportedYesYesHabitat

SUSE family

PlatformArchitectureVersionTierAgentAgentlessInstaller
SUSE Linux Enterprise Serverx86_64, aarch6415, 16Validated and supportedYesYesNative, Habitat
SUSE Linux Enterprise Servers390x15, 16Validated and supportedNoYesHabitat
openSUSEx86_64, aarch6416.xUser-reportedYesYesHabitat
SUSE Linux Enterprise Desktopx86_64, aarch6415.x, 16.xUser-reportedYesYesHabitat

Windows

PlatformArchitectureVersionTierAgentAgentlessInstaller
Windowsx86_6411, Server 2019 (LTSC), 2022, 2025Validated and supportedYesYesNative (MSI)
Windows Server, Semi-annual channel (SAC)x64Server Core onlyUser-reportedYesYesHabitat

macOS

PlatformArchitectureVersionTierAgentAgentlessInstaller
macOSaarch6414.x, 15.x, 26.xValidated and supportedYesYesNative

IBM AIX

PlatformArchitectureVersionTierAgentAgentlessInstaller
IBM AIXpowerpc7.2, 7.3Validated and supportedNoYesHabitat

Oracle Solaris

PlatformArchitectureVersionTierAgentAgentlessInstaller
Oracle Solarisi86pc11.4Validated and supportedNoYesHabitat
Oracle Solarissparc11.4Validated and supportedNoYesHabitat

FreeBSD

PlatformArchitectureVersionTierAgentAgentlessInstaller
FreeBSDamd6414.x, 15.xValidated and supportedYesYesHabitat

Specialized and network Linux

PlatformArchitectureVersionTierAgentAgentlessInstaller
Arista EOSx86_64current non-EOL releasesUser-reportedYesYesHabitat
Cumulus Linuxx86_64current non-EOL releasesUser-reportedYesYesHabitat
XCP-ngx86_648.3User-reportedYesYesHabitat

Other community platforms

PlatformArchitectureVersionTierAgentAgentlessInstaller
Alibaba Cloud Linuxx86_643.xUser-reportedYesYesHabitat
Arch Linuxx86_64current versionUser-reportedYesYesHabitat
OpenIndiana Hipsterx86_64current non-EOL releasesUser-reportedYesYesHabitat
SmartOSx86_64current non-EOL releasesUser-reportedYesYesHabitat
Virtuozzox86_64current non-LTS releasesUser-reportedYesYesHabitat

Validated and supported platforms

The following table lists the validated and supported platforms and versions for Chef Infra Client 18.

PlatformArchitectureVersion
AIXpowerpc7.1 (TL5 SP2 or higher, recommended), 7.2, 7.3
Amazon Linuxx86_64, aarch642.x, 2023
CentOSx86_64, ppc64le, ppc64, aarch647.x
Debianx86_64, aarch6410, 11, 13
FreeBSDamd6413.x
macOSaarch6413.x, 14.x
Oracle Linuxx86_64, aarch647.x, 8.x
Red Hat Enterprise Linuxx86_64, ppc64le (7.x only), ppc64 (7.x only), aarch64, s390x (7.x / 8.x only)7.x, 8.x, 9.x, 10.x
Rocky Linuxx86_64, aarch648.x, 9.x
Solarissparc, i86pc11.3 (16.17.4 and later only), 11.4
SUSE Linux Enterprise Serverx86_64, aarch64 (15.x only), s390x12, 15
Ubuntu (LTS releases)x86_64,aarch64 (18.x and above)18.04, 20.04, 22.04, 24.04, 26.04
Windowsx86_642016, 10 (all channels except “insider” builds), 2019 (Long-term servicing channel (LTSC), both Desktop Experience and Server Core), 11, 2022, 2025

Supported (untested) platforms

The following table lists supported derived platforms and versions for Chef Infra Client 18.

PlatformArchitectureVersionParent platform
AlmaLinuxx86_64, aarch648.x, 9.x, 10.xCentOS

User-reported platforms

The following are user-reported platforms for Chef Infra Client 18.

PlatformArchitectureVersion
Alibaba Cloud Linuxx86_642.x
Arch Linuxx86_64current version
Arista EOSx86_64current non-EOL releases
CentOS Streamx86_64, aarch64current non-EOL releases
Clear Linuxx86_64current non-EOL releases
Cumulus Linuxx86_64current non-EOL releases
Fedorax86_64, aarch64current non-EOL releases
Kali Linuxx86_64current non-EOL releases
Linux Mintx86_64current non-EOL releases
OpenIndiana Hipsterx86_64current non-EOL releases
openSUSEx86_64, aarch6415.x
Pop!_OSx86_64current non-EOL releases
Raspberry Pi OSaarch64current non-EOL releases
SmartOSx86_64current non-EOL releases
SUSE Linux Enterprise Desktopx86_64, aarch64 (15.x only)12.x, 15.x
Ubuntux86_64, aarch64Current non-LTS releases
Virtuozzox86_64Current non-LTS releases
Windowsx64Windows Server, Semi-annual channel (SAC) (Server Core only)
XCP-ngx86_648.x

Chef Infra Server

The following table lists the commercially supported platforms for Chef Infra Server:

PlatformArchitectureVersion
Amazon Linuxx86_642, 2023
Red Hat Enterprise Linuxx86_648.x, 9.x
Rocky Linuxx86_649.x
SUSE Linux Enterprise Serverx86_6412.x, 15.x
Ubuntux86_6420.04, 22.04

Chef InSpec

PlatformArchitecturePlatform-native PackageHabitat Package
macOSARM64NoYes
Windowsx86-64YesYes
Debian-based Linux distributionsx86-64, ARM64YesYes
RPM-based Linux distributionsx86-64, ARM64YesYes
PlatformArchitecturePlatform-native PackageHabitat Package
Windowsx86-64YesYes
Debian-based Linux distributionsx86-64YesYes
RPM-based Linux distributionsx86-64YesYes
PlatformArchitecturePlatform-native PackageHabitat Package
Windowsx86-64NoYes
Debian-based Linux distributionsx86-64NoYes
RPM-based Linux distributionsx86-64NoYes

Commercially supported platforms

PlatformArchitectureVersion
Amazon Linuxx86_64, aarch642.x
Debianx86_64, aarch64 (10.x only)9, 10, 11
macOSx86_64, aarch64 (M1 processors)11.x, 12.x
Oracle Linuxx86_64, aarch64 (7.x / 8.x only)6.x, 7.x, 8.x
Red Hat Enterprise Linuxx86_64, aarch64 (7.x, 8.x and 9.x only)7.x, 8.x, 9.x
SUSE Linux Enterprise Serverx86_64, aarch64 (15.x only)12.x, 15.x
Ubuntux86_6416.04, 18.04, 20.04
Windowsx86_648.1, 2012, 2012 R2, 2016, 10 (all channels except “insider” builds), 2019, 11, 2022

Supported derived platforms

PlatformArchitectureVersionParent platform
AlmaLinuxx86_64, aarch648.xCentOS
Rocky Linuxx86_64, aarch648.xCentOS

Chef InSpec Target Mode (inspec --target) may be functional on additional platforms, versions, and architectures but aren’t validated by Chef.

Validated and supported platforms

The following table lists the validated and supported platforms and versions for Chef InSpec.

PlatformArchitectureVersion
Amazon Linuxx86_64, aarch642.x, 2023
Debianx86_64, aarch64 (10.x and 11.x)9, 10, 11
macOSx86_64, aarch64 (M1 processors)13.x, 14.x
Oracle Linuxx86_64, aarch647.x, 8.x, 9.x
Red Hat Enterprise Linuxx86_64, aarch64 (7.x and 8.x only)7.x, 8.x, 9.x, 10.x
SUSE Linux Enterprise Serverx86_64, aarch64 (15.x only)12.x, 15.x
Ubuntux86_64, aarch64 (only 18.04 and 20.04)16.04, 18.04, 20.04
Windowsx86_642016, 10 (all channels except “insider” builds), 2019, 11, 2022, 2025

Supported (untested) platforms

The following table lists supported derived platforms and versions for Chef InSpec.

PlatformArchitectureVersionParent platform
AlmaLinuxx86_64, aarch648.xCentOS
Rocky Linuxx86_64, aarch648.xCentOS

Chef InSpec Target Mode (inspec --target) may be functional on additional platforms, versions, and architectures but aren’t validated by Chef Software, Inc.

Validated and supported platforms

The following table lists the validated and supported platforms and versions for Chef InSpec.

PlatformArchitectureVersion
Amazon Linuxx86_64, aarch642.x
Debianx86_64, aarch64 (10.x and 11.x)9, 10, 11
macOSx86_64, aarch64 (M1 processors)12.x, 13.x, 14.x
Oracle Linuxx86_64, aarch647.x, 8.x, 9.x
Red Hat Enterprise Linuxx86_64, aarch64 (7.x and 8.x only)7.x, 8.x, 9.x
SUSE Linux Enterprise Serverx86_64, aarch64 (15.x only)12.x, 15.x
Ubuntux86_64, aarch64 (only 18.04 and 20.04)16.04, 18.04, 20.04
Windowsx86_642016, 10 (all channels except “insider” builds), 2019, 11, 2022

Supported (untested) platforms

The following table lists supported derived platforms and versions for Chef InSpec.

PlatformArchitectureVersionParent platform
AlmaLinuxx86_64, aarch648.xCentOS
Rocky Linuxx86_64, aarch648.xCentOS

Chef InSpec Target Mode (inspec --target) may be functional on additional platforms, versions, and architectures but aren’t validated by Chef Software, Inc.

Chef Workstation

Chef Workstation 26.1 is supported on:

PlatformArchitectureSupported Version
Linuxx86_64 (amd64)Currently supported Linux distributions running Linux kernel 2.6.32 or later
Windowsx86_64 (64-bit)Windows 10 or later; Windows Server 2016 or later

Chef Workstation 26.0 is supported on:

  • Linux (x86_64)
  • Windows (x86_64)

Chef Workstation 25 is commercially supported on the following platforms and versions:

PlatformVersionArchitecture
Amazon Linux2.xx86_64
Amazon Linux2023x86_64, aarch64
macOS13.x, 14.xaarch64
Debian10.x, 11.xx86_64
Red Hat Enterprise Linux / CentOS7.x, 8.x, 9.xx86_64
Ubuntu18.04, 20.04, 22.04x86_64
Windows10, 11, Server 2016, Server 2019, Server 2022x64

Chef Workstation 25 supports the following derived platforms and versions:

PlatformVersionArchitectureParent platform
AlmaLinux8.xx86_64CentOS
Rocky Linux8.xx86_64CentOS

Platform end-of-life policy

Chef’s products on particular platforms and versions reach end-of-life on the same date as the vendor EOL milestone for that operating system. Because different vendors use different terminology, the following table clarifies when Chef products are end-of-life according to those vendors’ terms.

PlatformVendor End-of-Life
Amazon LinuxEnd of Life
Apple macOSApple supports the last three macOS releases. Apple doesn’t officially publish EOL dates.
DebianEnd of maintenance updates
Enterprise Linux (covers Red Hat Enterprise Linux, CentOS)End of Production 3
FreeBSDEnd of Life
IBM AIXIBM End of Support Date
WindowsEnd of Extended Support
Oracle LinuxPremier Support Ends
Oracle SolarisPremier Support Ends
SUSE Linux Enterprise ServerGeneral Support Ends
Ubuntu LinuxEnd of maintenance updates

At Chef’s option, additional support may be provided to customers beyond the vendor end-of-life in the above table. As such, the following table indicates upcoming product end-of-life dates for particular platforms. On the Chef end-of-life date, Chef discontinues building software for that platform and version.

Edit this page on GitHub

Thank you for your feedback!

×