Start with installation,
man brew,
troubleshooting and
FAQ (Frequently Asked Questions) guides if you are new to Homebrew.
Documentation is grouped below by audience: users, system administrators, contributors, maintainers and those interested in Homebrew’s governance.
Users
brewmanual page (command documentation, also available withman brew)- Homebrew Blog (news on major updates)
- Installation
- Support Tiers
- Troubleshooting
- FAQ (Frequently Asked Questions)
- Common Issues
brewShell Completion- Command Not Found
- Homebrew on Linux
- Homebrew Bundle,
brew bundleandBrewfile - Bottles (binary packages)
- Taps (third-party repositories)
- Trusting Taps
- Homebrew Security and Supply Chain
- Interesting Taps and Forks
- Tips and Tricks
- Querying
brew - C++ Standard Libraries
- Custom GCC and Cross-Compilers
- External Commands
- Language Runtimes and Packages
- Creating a Homebrew Issue
- Updating Software in Homebrew
- Adding Software to Homebrew
Teams
System administrators
- Homebrew Software Inventory, SBOMs and Audit Reporting
- Homebrew Vulnerability Scanning and Patch Management
- Homebrew Package Policies and Supply Chain Protection
Mac Admins
- Homebrew for Mac Admins: MDM and Non-Admin Accounts
- Homebrew Fleet Management with MDM and Brewfiles
- Jamf Pro
- Iru (formerly Kandji)
- Microsoft Intune
- Other MDMs
Contributors
- How to Open a Homebrew Pull Request (and get it merged)
- Responsible AI Usage
- Working with Homebrew as an Upstream Project
- Formula Cookbook
- Cask Cookbook
- Acceptable Formulae
- Acceptable Casks
- Package Acceptance Policy
- Licence Guidelines
- Description Guidelines
- Checksum Requirements
- Formulae Versions
- Deprecating, Disabling and Removing
- Language-Specific Formulae
brew livecheck- Autobump
- Migrating a Formula to a Tap
- Renaming a Formula
- Building Against Non-Homebrew Dependencies
- How to Create and Maintain a Tap
- BrewTestBot
- Prose Style Guidelines
- Type Checking with Sorbet
- Ruby API Documentation (e.g. for
Formula,Casketc.)
Maintainers
- New Maintainer Checklist
- Maintainer Guidelines
- Homebrew/brew Maintainer Guide
- Homebrew/homebrew-core Maintainer Guide
- BrewTestBot for Maintainers
- Advisory Matching
- Common Issues for Maintainers
- Linux CI
- Xcode
Governance
- Homebrew Governance
- Homebrew Leadership Responsibilities
- Homebrew Governance Archives
- Homebrew’s Expense and Reimbursement Policy
- How To Organise the Homebrew AGM
- Homebrew’s Maintainer Stipends and Grants