Homebrew Deployment (macOS PKG)

Deploy Homebrew with the official macOS package

Use Homebrew’s official PKG to install Homebrew through a standard FileWave PKG Fileset. On Apple Silicon Macs, Homebrew installs at its normal location, /opt/homebrew. No custom installation or verification scripts are required for the workflow below.

Before you start

• This procedure is for a new Homebrew installation on an Apple Silicon Mac. Check Homebrew’s current macOS requirements before deployment.
• For the usual user-owned installation, have the intended user logged in when the package runs. Without an owner override, the installer uses the active console user.
• If you need to install before anyone logs in, or use a dedicated account, configure Homebrew’s documented account selection first. See Homebrew for Mac Admins. The selected account must already exist.

If Homebrew is already installed, review its ownership and maintenance needs rather than redeploying this initial-install recipe over it.

Create and deploy the Fileset

1. Download Homebrew.pkg from the latest official Homebrew release.
2. Drag the PKG into the Filesets view in FileWave Central. FileWave creates a PKG Fileset that runs the installer when deployed.
3. Give the Fileset a clear name, such as Homebrew, and record the downloaded package version in its revision name. Set the requirements to the supported macOS versions and Apple Silicon devices you intend to target.
4. Create a Deployment for a test Mac. Review its selected revision and targets, then run Update Model.
5. Confirm the installation result in FileWave and verify Homebrew on the Mac before expanding the Deployment.

For the standard import and revision workflow, see Create and Update PKG and MSI Filesets.

Check the result

As the account that owns Homebrew, open Terminal and run:

/opt/homebrew/bin/brew --version
/opt/homebrew/bin/brew --prefix

Expect a Homebrew version and the prefix /opt/homebrew. Confirm that the intended user can install and use a representative package before deploying more widely.

After installation

The PKG installs Homebrew, not a predefined set of applications. Manage packages and updates as the Homebrew-owning account using Homebrew’s administration guidance. Install compatible Command Line Tools or Xcode when your planned Homebrew operations require them; a separate Command Line Tools installation script is not part of this recipe.

Leave the Fileset’s uninstall script sections empty. Removing the Deployment does not run a Homebrew uninstaller. If you need to remove Homebrew, review the software that depends on it and follow Homebrew’s uninstallation instructions separately.