From a1b3a64d9e19fdce12b49957c41246e2195f399c Mon Sep 17 00:00:00 2001 From: nikhil2611 Date: Wed, 12 Aug 2026 12:20:22 +0530 Subject: [PATCH 1/2] Add macOS ARM64 native installer documentation This PR adds documentation for the new macOS ARM64 (Apple Silicon) native installer support in Chef Workstation 26.1+. Changes: - install.md: Added macOS ARM64 to supported platforms, documented DMG installation steps - uninstall.md: Added macOS uninstall section using the uninstall.sh script - upgrade.md: Added macOS upgrade process Details: - macOS installer uses DMG format with PKG inside - Binaries installed to /opt/hab/ (2.4 GB disk space) - Symlinks created in /usr/local/bin/ (not /usr/bin/ due to macOS SIP) - PATH configured via /etc/paths.d/chef-workstation-enterprise - Uninstall via dedicated script at /opt/hab/chef-workstation/uninstall.sh - Supports clean install and upgrade scenarios Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- content/workstation/26.1/install.md | 42 +++++++++++++++++++++++++-- content/workstation/26.1/uninstall.md | 18 +++++++++++- content/workstation/26.1/upgrade.md | 32 +++++++++++++++++++- 3 files changed, 88 insertions(+), 4 deletions(-) diff --git a/content/workstation/26.1/install.md b/content/workstation/26.1/install.md index 1cebe917c..29f945c4a 100644 --- a/content/workstation/26.1/install.md +++ b/content/workstation/26.1/install.md @@ -11,8 +11,8 @@ draft = false {{< readfile file="content/workstation/26.1/reusable/md/workstation_modularize.md" >}} -The Chef Workstation native installers provide an efficient way to install Chef Workstation on Windows, Debian, or RPM-based Linux distributions. -You can download and install the pre-built `.msi`, `.deb`, or `.rpm` packages using your existing package management tools, simplifying the deployment process for managing system configurations. +The Chef Workstation native installers provide an efficient way to install Chef Workstation on Windows, Debian, RPM-based Linux distributions, and macOS. +You can download and install the pre-built `.msi`, `.deb`, `.rpm`, or `.dmg` packages using your existing package management tools, simplifying the deployment process for managing system configurations. ## Supported platforms @@ -20,6 +20,7 @@ Chef Workstation is supported on: - Currently supported Linux distributions and versions running Linux kernel 2.6.32 and later on x86-64 (amd64) - Currently supported Windows versions greater than or equal to Windows 10 and Windows Server 2016 +- macOS 14 (Sonoma) on Apple Silicon (ARM64/aarch64) ## Chef Workstation requirements @@ -27,6 +28,7 @@ Chef Workstation is supported on: - **Disk space for binaries**: - Linux: The Chef Workstation binaries are stored in `/hab` and require a minimum of 2.8 GB of disk space. - Windows: The Chef Workstation binaries are stored in `C:\hab` and require a minimum of 3.3 GB of disk space. + - macOS: The Chef Workstation binaries are stored in `/opt/hab` and require a minimum of 2.4 GB of disk space. ## Prerequisites @@ -131,6 +133,42 @@ To install Chef Workstation on Windows, follow these steps: Replace `` with the version number of the downloaded package, for example `chef-workstation-enterprise-26.1.0-1_x86_64.msi`. +### Install Chef Workstation on macOS + +To install Chef Workstation on macOS (Apple Silicon), follow these steps: + +1. Download the installer using one of the following methods: + + - Download using `curl`: + + ```shell + curl -o "chef-workstation-enterprise--darwin.dmg" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=&m=aarch64&p=mac_os_x&pm=dmg&v=" + ``` + + - Download using `wget`: + + ```shell + wget -O "chef-workstation-enterprise--darwin.dmg" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=&m=aarch64&p=mac_os_x&pm=dmg&v=" + ``` + + Replace: + - `` with the version number to install. + - `` with your Chef license ID. + +1. Install Chef Workstation using one of the following methods: + + - Double-click the `.dmg` file, then double-click the `.pkg` file inside and follow the on-screen installation wizard. + + - Run the following commands: + + ```shell + hdiutil attach chef-workstation-enterprise--darwin.dmg + sudo installer -pkg "/Volumes/Chef Workstation Enterprise /chef-workstation-enterprise--1_arm64.pkg" -target / + hdiutil detach "/Volumes/Chef Workstation Enterprise " + ``` + + Replace `` with the version number of the downloaded package, for example `chef-workstation-enterprise-26.1.0-1`. + ## Verify the installation After installation, verify that Chef Workstation is installed correctly by running one of the following commands: diff --git a/content/workstation/26.1/uninstall.md b/content/workstation/26.1/uninstall.md index 603aec771..ef5864dde 100644 --- a/content/workstation/26.1/uninstall.md +++ b/content/workstation/26.1/uninstall.md @@ -8,7 +8,7 @@ draft = false weight = 70 +++ -Use these steps to remove Chef Workstation from Debian-based, RPM-based, or Windows systems. +Use these steps to remove Chef Workstation from Debian-based, RPM-based, Windows, or macOS systems. ## Uninstall Chef Workstation on Debian-based distributions @@ -62,6 +62,22 @@ msiexec /x chef-workstation-enterprise-_x86_64.msi Replace `` with the version number of the currently installed package. +## Uninstall Chef Workstation on macOS + +To uninstall Chef Workstation on macOS, run the uninstaller script: + +```shell +sudo /opt/hab/chef-workstation/uninstall.sh +``` + +This script will: + +- Remove all Chef Workstation binaries from `/usr/local/bin/` +- Remove the installation directory `/opt/hab/` +- Remove the PATH configuration from `/etc/paths.d/chef-workstation-enterprise` +- Remove the installation metadata from `/Library/Application Support/chef-workstation-enterprise/` +- Forget the package receipt using `pkgutil` + ## See also - [Install Chef Workstation](install) diff --git a/content/workstation/26.1/upgrade.md b/content/workstation/26.1/upgrade.md index 13b2ae72c..1465c300f 100644 --- a/content/workstation/26.1/upgrade.md +++ b/content/workstation/26.1/upgrade.md @@ -7,7 +7,7 @@ title = "Upgrade Chef Workstation and its components" weight = 30 +++ -Chef Workstation 26.1 and later uses native installers for Debian, RPM, and Windows. +Chef Workstation 26.1 and later uses native installers for Debian, RPM, Windows, and macOS. To upgrade, install the latest version for your operating system. ## Upgrade on Debian-based systems @@ -98,6 +98,36 @@ To upgrade Chef Workstation on Windows, follow these steps: Replace `` with the version number of the downloaded package. +## Upgrade on macOS + +To upgrade Chef Workstation on macOS, follow these steps: + +1. Download the latest installer: + + ```shell + curl -o "chef-workstation-enterprise--darwin.dmg" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=&m=aarch64&p=mac_os_x&pm=dmg&v=" + ``` + + Replace: + - `` with the version number to upgrade to. + - `` with your Chef license ID. + +1. Install the new version using one of the following methods: + + - Double-click the `.dmg` file, then double-click the `.pkg` file inside and follow the on-screen installation wizard. + + - Run the following commands: + + ```shell + hdiutil attach chef-workstation-enterprise--darwin.dmg + sudo installer -pkg "/Volumes/Chef Workstation Enterprise /chef-workstation-enterprise--1_arm64.pkg" -target / + hdiutil detach "/Volumes/Chef Workstation Enterprise " + ``` + + The installer will automatically detect and upgrade your existing installation. + + Replace `` with the version number of the downloaded package. + ## Next steps - [Set up Workstation](/workstation/26.1/set_up/) From c37577aaa595d6784c03ee8c8de295ff64900d7e Mon Sep 17 00:00:00 2001 From: nikhil2611 Date: Wed, 12 Aug 2026 12:29:01 +0530 Subject: [PATCH 2/2] Trigger DCO check Empty commit to re-run DCO verification Signed-off-by: nikhil2611