First pass on updates for Quattro

2026-08-13 15:18:33 +02:00
parent 9c9e082954
commit 144f4d1e31
42 changed files with 474 additions and 283 deletions
@@ -0,0 +1,71 @@
+# Mac support
+
+Omarchy has built-in support for **Intel Macs**. There are a couple of known limitations at the moment, but as long as you're aware and OK with those; you can breathe some new life into your old Macs by loading Omarchy.
+
+Please note that installing on an M-series Mac is not directly supported at this time. You can find out more about the state of this in #omarchy-on-other in our [Discord](https://discord.gg/tXFUdasqhY).
+
+In a simple test, we were able to achieve 36% performance gains on a 2019 MacBook Pro just by installing Omarchy.
+
+ ![G0-1NXRWQAAn_IH.jpeg](https://learn.omacom.io/u/g0-1nxrwqaan_ih-nOdzdG.jpeg)
+
+### Installing Omarchy on Mac
+
+Omarchy only supports being the **only** OS installed at the moment. During the installation, the drive will be wiped and MacOS will no longer be bootable.
+
+You can still restore it later via Internet Recovery if you'd like.
+
+For the sake of this part, we'll assume you've already reviewed [Getting Started](02-getting-started.md) and have your USB drive ready. If you don't go ahead and do that now.
+
+#### Disable Secure Boot
+
+It is necessary to disable Apple's Secure Boot in order to boot the bootable USB, as well as the OS. To disable it, perform the following:
+
+1. Turn off your Mac
+2. Turn it on and _immediately_ press and hold Command-R until you see the loading screen appear
+3. Select your user and enter your password if prompted
+4. Once in the recovery screen, choose **Utilities > Startup Security Utility** from the menubar
+5. Enter your password when prompted to authenticate
+6. Choose "No Security" from the Secure Boot options
+7. Choose "Allow booting from external or removable media" from the External Boot options
+
+#### Start the Installation
+
+1. Insert the USB drive
+2. Restart your Mac and _immediately_ press and hold Option until you see a screen of boot devices
+3. Select the orange EFI Boot device
+4. Proceed with the [install as normal](02-getting-started.md)
+
+The installer detects Mac hardware and applies the needed fixes automatically: Broadcom Wi-Fi drivers and firmware, the SPI keyboard driver on the MacBook models that need it, and an NVMe suspend fix for those same models.
+
+### Known Limitations
+
+Members of the community are constantly working on solutions to these challenges so if these are problematic for you, join #omarchy-on-other in our [Discord](https://discord.gg/tXFUdasqhY) and see if there's any up-to-date methods for resolving these.
+
+#### Devices with T1 Chip
+
+The Apple T1 chip was introduced in late 2016 and used exclusively in the first-generation MacBook Pro models with Touch Bar.
+- MacBook Pro 13-inch (2016, two Thunderbolt 3 ports) – Model: A1706
+- MacBook Pro 13-inch (2016, four Thunderbolt 3 ports) – Model: A1708
+- MacBook Pro 15-inch (2016) – Model: A1707
+
+#### Known Issues
+
+- Touch Bar is non-functional
+- Sound is not functioning
+
+#### Devices with T2 Chip
+
+The Apple T2 Security Chip was introduced in 2017. The T2 chip was discontinued with the transition to Apple silicon (M-series chips) starting in 2020.
+
+- iMac Pro (2017) – Model: A1862
+- MacBook Pro 13-inch (2018, four Thunderbolt 3 ports) – Model: A1989
+- MacBook Pro 15-inch (2018) – Model: A1990
+- MacBook Air (Retina, 13-inch, 2018) – Model: A1932
+- Mac mini (2018) – Model: A1998
+- MacBook Pro 13-inch (2019, two Thunderbolt 3 ports) – Model: A2159
+- MacBook Pro 13-inch (2019, four Thunderbolt 3 ports) – Model: A2178
+- MacBook Pro 15-inch (2019) – Model: A1990
+- MacBook Pro 13-inch (2020, two Thunderbolt 3 ports) – Model: A2265
+- MacBook Pro 15-inch (2020) – Model: A1990
+
+On these models, the installer automatically sets up the patched `linux-t2` kernel, the T2 audio configuration, Apple's Broadcom Wi-Fi/Bluetooth firmware, and fan control via `t2fanrd`. The Touch Bar runs on the kernel's built-in Boot Camp-style support.