mirrors/brew
1
0
Fork 0
mirror of https://github.com/Homebrew/brew.git synced 2025-07-14 16:09:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #19751 from Homebrew/support-tiers-westmere

Browse Source 
Support-Tiers: clarify OCLP tiers based on CPU generation
This commit is contained in:
Patrick Linnane 2025-04-13 20:23:28 +00:00 committed by GitHub
commit ee80a2daca
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/Installation.md
View File

@ -118,7 +118,7 @@ Uninstallation is documented in the [FAQ](FAQ.md#how-do-i-uninstall-homebrew).
<a data-proofer-ignore name="1"><sup>1</sup></a> For 32-bit or PPC support see [Tigerbrew](https://github.com/mistydemeo/tigerbrew). <a data-proofer-ignore name="1"><sup>1</sup></a> For 32-bit or PPC support see [Tigerbrew](https://github.com/mistydemeo/tigerbrew).
<a data-proofer-ignore name="2"><sup>2</sup></a> macOS 13 (Ventura) or higher is best and supported, 10.11 (El Capitan) – 12 (Monterey) are unsupported but may work and 10.10 (Yosemite) and older will not run Homebrew at all. For 10.4 (Tiger) – 10.6 (Snow Leopard) see [Tigerbrew](https://github.com/mistydemeo/tigerbrew). Using OpenCore Legacy Patcher is a [Tier 2 configuration](Support-Tiers.md#tier-2). <a data-proofer-ignore name="2"><sup>2</sup></a> macOS 13 (Ventura) or higher is best and supported, 10.11 (El Capitan) – 12 (Monterey) are unsupported but may work and 10.10 (Yosemite) and older will not run Homebrew at all. For 10.4 (Tiger) – 10.6 (Snow Leopard) see [Tigerbrew](https://github.com/mistydemeo/tigerbrew). Using OpenCore Legacy Patcher is a [Tier 2](Support-Tiers.md#tier-2) or [Tier 3](Support-Tiers.md#tier-3) configuration depending on CPU generation.
<a data-proofer-ignore name="3"><sup>3</sup></a> You may need to install Xcode, the CLT, or both depending on the formula, to install a bottle (binary package) which is the only supported configuration. Downloading Xcode may require an Apple Developer account on older versions of Mac OS X. Sign up for free at [Apple's website](https://developer.apple.com/account/). <a data-proofer-ignore name="3"><sup>3</sup></a> You may need to install Xcode, the CLT, or both depending on the formula, to install a bottle (binary package) which is the only supported configuration. Downloading Xcode may require an Apple Developer account on older versions of Mac OS X. Sign up for free at [Apple's website](https://developer.apple.com/account/).

14
docs/Support-Tiers.md
View File

@ -4,8 +4,7 @@ last_review_date: "2025-04-12"
# Support Tiers # Support Tiers
Homebrew has three support tiers. Homebrew has three support tiers. These tiers set expectations for how well Homebrew will run on a given configuration.
These set expectations for how well Homebrew will run on a given configuration.
## Tier 1 ## Tier 1
@ -28,7 +27,7 @@ For Tier 1 support, Homebrew on macOS must be all of:
- installed in the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Intel x86_64) - installed in the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Intel x86_64)
- running on a supported architecture (i.e. Apple Silicon or Intel x86_64) - running on a supported architecture (i.e. Apple Silicon or Intel x86_64)
- not building official packages from source - not building official packages from source
- installed on your Mac's built-in hard-drive (i.e. not external/removable storage) - installed on your Mac's built-in hard drive (i.e. not external/removable storage)
- you have `sudo` access on your system - you have `sudo` access on your system
- the Xcode Command Line Tools are installed and fully up-to-date - the Xcode Command Line Tools are installed and fully up-to-date
@ -39,7 +38,7 @@ For Tier 1 support, Homebrew on Linux must be all of:
- running on Ubuntu or a Homebrew-provided Docker image - running on Ubuntu or a Homebrew-provided Docker image
- have a system `glibc` >= 2.35 - have a system `glibc` >= 2.35
- have a Linux kernel >= 3.2 - have a Linux kernel >= 3.2
- if running Ubuntu, running an Ubuntu version in "standard support": <https://ubuntu.com/about/release-cycle> - if running Ubuntu, using an Ubuntu version in "standard support": <https://ubuntu.com/about/release-cycle>
- installed in the default prefix (i.e. `/home/linuxbrew/.linuxbrew`) - installed in the default prefix (i.e. `/home/linuxbrew/.linuxbrew`)
- running on a supported architecture (i.e. Intel x86_64) - running on a supported architecture (i.e. Intel x86_64)
- not building official packages from source - not building official packages from source
@ -59,11 +58,11 @@ A Tier 2 supported configuration is one in which any of:
Tier 2 configurations include: Tier 2 configurations include:
- macOS prereleases before we state they are Tier 1 (e.g. in March 2025, macOS 16, whatever it ends up being called) - macOS prereleases before we state they are Tier 1 (e.g. in March 2025, macOS 16, whatever it ends up being called)
- Linux versions where a system `glibc` < 2.35 (but still >= 2.13), so the Homebrew `glibc` formula is automatically installed - Linux versions with a system `glibc` version < 2.35 (but >= 2.13), requiring the Homebrew `glibc` formula to be installed automatically
- using official packages that need to be built from source due to installing Homebrew outside the default prefix - using official packages that need to be built from source due to installing Homebrew outside the default prefix
(i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux) (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux)
- running on a not-yet-supported architecture (i.e. Linux ARM64/AARCH64) - running on a not-yet-supported architecture (i.e. Linux ARM64/AARCH64)
- devices using OpenCore Legacy Patcher - devices using OpenCore Legacy Patcher with a Westmere or newer Intel CPU
## Tier 3 ## Tier 3
@ -86,6 +85,7 @@ Tier 3 configurations include:
- installing Homebrew outside the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux) - installing Homebrew outside the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux)
- installing formulae using `--HEAD` - installing formulae using `--HEAD`
- installing deprecated or disabled formulae - installing deprecated or disabled formulae
- devices using OpenCore Legacy Patcher with an Intel CPU older than Westmere
## Unsupported ## Unsupported
@ -105,7 +105,7 @@ Unsupported configurations include:
## Unsupported Software ## Unsupported Software
Note that all packages installed from third-party taps outside of the Homebrew GitHub organisation are unsupported by default. All packages installed from third-party taps outside of the Homebrew GitHub organisation are unsupported by default.
We may assist the maintainers/contributors/developers of such packages to fix bugs with the Homebrew formula/cask/tap system, but we are not responsible for resolving issues when using that software. We may assist the maintainers/contributors/developers of such packages to fix bugs with the Homebrew formula/cask/tap system, but we are not responsible for resolving issues when using that software.