Homebrew is the package manager many people already use on macOS and Linux. Orchard ships through the Artemis Labs tap, so installing and upgrading is one command.
Install
$brew install artemis-inc/orchard/orchard
That command taps the formula and installs the orch command in one step. Check it with orch --version.
Tap first, install later
If you prefer to add the tap on its own:
$brew tap artemis-inc/orchard
$brew install artemis-inc/orchard/orchard
Use the full artemis-inc/orchard/orchard name rather than just orchard, so Homebrew always picks this formula.
Upgrade and remove
- Upgrade with
brew upgrade artemis-inc/orchard/orchard. - Remove with
brew uninstall artemis-inc/orchard/orchard. - Remove the tap with
brew untap artemis-inc/orchard.
Troubleshooting
- “already installed and up-to-date” but a newer version exists. Homebrew caches the tap; refresh it with
brew updateand run the install again. To force the current release, usebrew reinstall artemis-inc/orchard/orchard. - “Treating orchard as a cask” or “Cask ‘orchard’ is not installed.” The bare name
orchardcollides with an unrelated Homebrew cask. Always use the fullartemis-inc/orchard/orchardfor install, upgrade, and uninstall. The installed command isorch, notorchard. - An older
orchstill runs after upgrading. You may have a second copy from the install script or the macOS.pkg. Check withwhich -a orch; Homebrew’s lives in$(brew --prefix)/bin/orch.
How the tap works. The formula points at the official release archives and verifies each one by checksum, so a Homebrew install is the same build as a direct download. The tap lives next to the main project under the Artemis Labs organisation, and the release workflow updates it automatically on every version, so
brew upgrade always tracks the latest. On a recent Homebrew you may be asked to run brew trust artemis-inc/orchard once before the first install.