Skip to main content

Supported platforms

This page lists the operating system platforms supported by Chef Infra Client 19.

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

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
CentOSx86_64, aarch647.xValidated and supportedYesYesNative, Habitat
CentOSppc64le, ppc647.xValidated and supportedNoYesHabitat
Oracle Enterprise Linuxx86_64, aarch647.x, 8.xValidated and supportedYesYesNative, Habitat
Amazon Linuxx86_64, aarch642.x, 2023Validated and supportedYesYesNative, Habitat
Rocky Linuxx86_64, aarch648.x, 9.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, aarch6410, 11Validated and supportedYesYesNative, Habitat
Ubuntu (LTS releases)x86_64, aarch6418.04, 20.04, 22.04, 24.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, aarch6412, 15Validated and supportedYesYesNative, Habitat
SUSE Linux Enterprise Servers390x12, 15Validated and supportedNoYesHabitat
openSUSEx86_64, aarch6415.xUser-reportedYesYesHabitat
SUSE Linux Enterprise Desktopx86_64, aarch6412.x, 15.xUser-reportedYesYesHabitat

Windows

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

macOS

PlatformArchitectureVersionTierAgentAgentlessInstaller
macOSaarch6413.x, 14.xValidated and supportedYesYesNative

IBM AIX

PlatformArchitectureVersionTierAgentAgentlessInstaller
IBM AIXpowerpc7.1 (TL5 SP2 or higher), 7.2, 7.3Validated and supportedNoYesHabitat

Oracle Solaris

PlatformArchitectureVersionTierAgentAgentlessInstaller
Oracle Solarisi86pc11.3 (16.17.4 and later only), 11.4Validated and supportedYesYesHabitat
Oracle Solarissparc11.3 (16.17.4 and later only), 11.4Validated and supportedNoYesHabitat

FreeBSD

PlatformArchitectureVersionTierAgentAgentlessInstaller
FreeBSDamd6413.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.xUser-reportedYesYesHabitat

Other community platforms

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

Thank you for your feedback!

×