Skip to content

Add macOS ARM64 native installer documentation - #33

Open
nikhil2611 wants to merge 5 commits into
mainfrom
nikhil/CHEF-34646-macos-arm-native-installer-docs
Open

Add macOS ARM64 native installer documentation#33
nikhil2611 wants to merge 5 commits into
mainfrom
nikhil/CHEF-34646-macos-arm-native-installer-docs

Conversation

@nikhil2611

Copy link
Copy Markdown
Contributor

Summary

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.8 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

Testing

  • Documentation builds successfully
  • Installation steps verified on macOS 14+ ARM64
  • Upgrade process verified
  • Uninstall process verified

Related

  • chef/chef-workstation-installer-scripts#12 (macOS native installer implementation)
  • CHEF-34644

- Add macOS ARM64 (Apple Silicon) to supported platforms
- Document macOS DMG installation steps with curl/wget download options
- Add macOS disk space requirements (/opt/hab)
- Document macOS uninstall process using uninstall.sh script
- Document macOS upgrade process with DMG installation
- Update all platform lists to include macOS

Signed-off-by: nikhil2611 <ngupta@progress.com>
@netlify

netlify Bot commented Jul 23, 2026

Copy link
Copy Markdown

Deploy Preview for chef-workstation-docs ready!

Name Link
🔨 Latest commit 3b56e21
🔍 Latest deploy log https://app.netlify.com/projects/chef-workstation-docs/deploys/6a6742095971090008a66b03
😎 Deploy Preview https://deploy-preview-33--chef-workstation-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@nikhil2611 nikhil2611 added the ai-assisted Changes created or updated with AI assistance label Jul 23, 2026
- Specify macOS 14 only (remove 'and later')
- Add double-click installation option like Windows
- Remove shell reload instructions (exec zsh)
- Simplify installation and upgrade steps

Signed-off-by: nikhil2611 <ngupta@progress.com>
Signed-off-by: nikhil2611 <ngupta@progress.com>
Updated the hdiutil detach command in both install and upgrade documentation
for macOS to use a quoted path format with the VERSION tag. This allows the
command to work correctly with the DMG volume name that includes the version number.

Changes:
- install.md: Updated hdiutil detach command to use quoted path with <VERSION> placeholder
- upgrade.md: Updated hdiutil detach command to use quoted path with <VERSION> placeholder

Signed-off-by: Nikhil Gupta <nikhil.gupta@progress.com>
@nikhil2611
nikhil2611 force-pushed the nikhil/CHEF-34646-macos-arm-native-installer-docs branch from 85eb8ad to 92ed114 Compare July 27, 2026 06:16
…e with version tag

Updated the sudo installer command in both install and upgrade documentation
for macOS to use a quoted path format with the VERSION tag and full package
name including the arm64 architecture suffix. This matches the actual DMG
volume structure and ensures compatibility across versions.

Changes:
- install.md: Updated sudo installer command path to include version in volume and full package name
- upgrade.md: Updated sudo installer command path to include version in volume and full package name

Signed-off-by: Nikhil Gupta <nikhil.gupta@progress.com>
@nikhil2611
nikhil2611 marked this pull request as ready for review July 29, 2026 05:38
@nikhil2611
nikhil2611 requested a review from a team as a code owner July 29, 2026 05:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-assisted Changes created or updated with AI assistance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant