You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/Support-Tiers.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,8 +4,7 @@ last_review_date: "2025-04-12"
4
4
5
5
# Support Tiers
6
6
7
-
Homebrew has three support tiers.
8
-
These set expectations for how well Homebrew will run on a given configuration.
7
+
Homebrew has three support tiers. These tiers set expectations for how well Homebrew will run on a given configuration.
9
8
10
9
## Tier 1
11
10
@@ -28,7 +27,7 @@ For Tier 1 support, Homebrew on macOS must be all of:
28
27
- installed in the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Intel x86_64)
29
28
- running on a supported architecture (i.e. Apple Silicon or Intel x86_64)
30
29
- not building official packages from source
31
-
- installed on your Mac's built-in hard-drive (i.e. not external/removable storage)
30
+
- installed on your Mac's built-in harddrive (i.e. not external/removable storage)
32
31
- you have `sudo` access on your system
33
32
- the Xcode Command Line Tools are installed and fully up-to-date
34
33
@@ -39,7 +38,7 @@ For Tier 1 support, Homebrew on Linux must be all of:
39
38
- running on Ubuntu or a Homebrew-provided Docker image
40
39
- have a system `glibc` >= 2.35
41
40
- have a Linux kernel >= 3.2
42
-
- if running Ubuntu, running an Ubuntu version in "standard support": <https://ubuntu.com/about/release-cycle>
41
+
- if running Ubuntu, using an Ubuntu version in "standard support": <https://ubuntu.com/about/release-cycle>
43
42
- installed in the default prefix (i.e. `/home/linuxbrew/.linuxbrew`)
44
43
- running on a supported architecture (i.e. Intel x86_64)
45
44
- not building official packages from source
@@ -59,11 +58,11 @@ A Tier 2 supported configuration is one in which any of:
59
58
Tier 2 configurations include:
60
59
61
60
- macOS prereleases before we state they are Tier 1 (e.g. in March 2025, macOS 16, whatever it ends up being called)
62
-
- Linux versions where a system `glibc` < 2.35 (but still >= 2.13), so the Homebrew `glibc` formula is automatically installed
61
+
- Linux versions with a system `glibc`version < 2.35 (but >= 2.13), requiring the Homebrew `glibc` formula to be installed automatically
63
62
- using official packages that need to be built from source due to installing Homebrew outside the default prefix
64
63
(i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux)
65
64
- running on a not-yet-supported architecture (i.e. Linux ARM64/AARCH64)
66
-
- devices using OpenCore Legacy Patcher
65
+
- devices using OpenCore Legacy Patcher with a Westmere or newer Intel CPU
67
66
68
67
## Tier 3
69
68
@@ -86,6 +85,7 @@ Tier 3 configurations include:
86
85
- 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)
87
86
- installing formulae using `--HEAD`
88
87
- installing deprecated or disabled formulae
88
+
- devices using OpenCore Legacy Patcher with an Intel CPU older than Westmere
Note that all packages installed from third-party taps outside of the Homebrew GitHub organisation are unsupported by default.
108
+
All packages installed from third-party taps outside of the Homebrew GitHub organisation are unsupported by default.
109
109
110
110
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.
0 commit comments