Skip to main content

Supported platforms

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

Support definitions

Certification tiers

Validated & Supported
These platforms are fully tested on every release. These platforms run through the complete Chef automated test suite in CI/CD before each release.
Supported (Untested)
These platforms are fully supported, but not tested in our CI/CD pipelines. Chef stands behind 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—MSI on Windows, DEB on Debian/Ubuntu, RPM on RHEL/SUSE, PKG on macOS.
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
Agent-based mode includes all software that runs directly on the managed node:
  • Chef Infra Client
  • Chef InSpec
  • Chef Habitat supervisor
  • Chef 360 skills running in agent mode, including Courier job execution and Node Management
Agentless
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, aarch647.x, 8.x, 9.x, 10.xValidated & SupportedYesYesNative, Habitat
Red Hat Enterprise Linuxs390x, ppc64le, ppc647.x, 8.xValidated & SupportedNoYesHabitat
CentOSx86_64, aarch647.xValidated & SupportedYesYesNative, Habitat
CentOSppc64le, ppc647.xValidated & SupportedNoYesHabitat
Oracle Enterprise Linuxx86_64, aarch647.x, 8.xValidated & SupportedYesYesNative, Habitat
Amazon Linuxx86_64, aarch642.x, 2023Validated & 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-EOL releasesUser ReportedYesYesHabitat
Fedorax86_64, aarch64current non-EOL releasesUser ReportedYesYesHabitat

Debian / Ubuntu family

PlatformArchitectureVersionTierAgentAgentlessInstaller
Debianx86_64, aarch6410, 11Validated & SupportedYesYesNative, Habitat
Ubuntu (LTS releases)x86_64, aarch6418.04, 20.04, 22.04, 24.04Validated & 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 & SupportedYesYesNative, Habitat
SUSE Linux Enterprise Servers390x12, 15Validated & 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 & SupportedYesYesNative (MSI)
Windows Server, Semi-annual channel (SAC)x64Server Core onlyUser ReportedYesYesHabitat

macOS

PlatformArchitectureVersionTierAgentAgentlessInstaller
macOSaarch6413.x, 14.xValidated & SupportedYesYesNative

IBM AIX

PlatformArchitectureVersionTierAgentAgentlessInstaller
IBM AIXpowerpc7.1 (TL5 SP2 or higher), 7.2, 7.3Validated & SupportedNoYesHabitat

Oracle Solaris

PlatformArchitectureVersionTierAgentAgentlessInstaller
Oracle Solarisi86pc11.3 (16.17.4 and later only), 11.4Validated & SupportedYesYesHabitat
Oracle Solarissparc11.3 (16.17.4 and later only), 11.4Validated & SupportedNoYesHabitat

FreeBSD

PlatformArchitectureVersionTierAgentAgentlessInstaller
FreeBSDamd6413.xValidated & 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!

×