Skip to content

Add macOS ARM64 native installer documentation#33

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

Add macOS ARM64 native installer documentation#33
nikhil2611 wants to merge 3 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 7cddfad
🔍 Latest deploy log https://app.netlify.com/projects/chef-workstation-docs/deploys/6a61e3bf2b824f00084214d0
😎 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>
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