MacBook Air T2 Setup
⚠️ Warning: This script will install the T2 kernel, configure GRUB, and prompt for a reboot. Make sure you've backed up any important data first.
Step 1: Initial Setup
Run this command to set up your T2 MacBook Air for Zorin OS:
Copy
bash <(curl -fsSL https://chrispyfur.net/zorin/t2-bootstrap.sh)
ℹ️ What this does:
Adds the T2 Ubuntu repository
Installs the T2 kernel and audio drivers
Configures GRUB with necessary boot parameters (intel_iommu=on iommu=pt pcie_ports=native)
Prompts for reboot
Step 2: After Reboot - WiFi and Bluetooth
ℹ️ Important: After rebooting into the T2 kernel, you need to install WiFi and Bluetooth firmware separately. This requires access to macOS firmware files.
Run this command after reboot:
Copy
sudo bash <(curl -fsSL https://wiki.t2linux.org/tools/firmware.sh)
The firmware script will give you two options:
Option 1: Mount your macOS partition (if you're dual-booting)Option 2: Download firmware directly from Apple's servers
Follow the on-screen prompts to complete the installation.
Ansible Playbook (Optional)
For automated deployment and configuration management, you can use the Ansible playbook instead of the bash script:
Copy
curl -fsSL https://chrispyfur.net/zorin/t2-macbook-air-zorin.yml -o t2-setup.yml && ansible-playbook t2-setup.yml
ℹ️ Ansible Benefits:
Idempotent - can be run multiple times safely
Declarative configuration approach
Better error handling and reporting
Automatic backup of GRUB configuration
The playbook performs the same operations as the bash script but with enterprise-grade configuration management.
Troubleshooting MacBook Air
If WiFi or Bluetooth don't work after running the firmware script, try rebooting again
If the keyboard or touchpad don't work, make sure you've booted into the T2 kernel (check with uname -r)
Audio should work automatically after installing apple-t2-audio-config
For more help, check the T2 Linux Wiki or join the Discord community
iMac 16,2 Audio Fix
If you have an iMac 16,2 with CS4208 codec and stereo audio isn't working properly, use this PipeWire remapping script:
Copy
bash <(curl -fsSL https://chrispyfur.net/zorin/imac-16,2-audio-fix.sh)
ℹ️ What this does:
Adds your user to the audio group (requires re-login)
Creates a PipeWire configuration to remap stereo to surround-40 output
Fixes stereo audio playback on iMac models with CS4208 codec
View the script source
Additional Resources
About This Guide
This simplified installation guide consolidates the T2 Linux installation process for Zorin OS. The original instructions and all technical work come from the T2 Linux community.
Credits & Sources:
This guide is based on work from the T2 Linux community and various contributors:
All credit for the T2 kernel patches, drivers, and tooling goes to the T2 Linux community.