14 KiB
Manjaro for T2 MacBooks
This repository contains the build scripts for compiling isos using the mbp-manjaro-kernel. With these iso files you can run Manjaro on 2018+ Macbook models with the T2 Chip.
Kernel Source: https://github.com/JPyke3/mbp-manjaro-kernel
Extra Modules: https://github.com/JPyke3/extramodules-mbp-manjaro
Repository: https://jacobpyke.xyz/archlinux/
Releases
Download the latest releases here
Installation Proccess
Hardware requirements:
- USB-C to ethernet cable adapter.
- Whilst you can install this over WiFi, it would make it alot easier to use an Adapter. If you would like to use the WiFi to set up Manjaro then refer to the "In order to get WiFi working" Section after you have booted Manjaro
- USB-C to USB Adapter
Steps
-
Partition your drive in MacOS ready for a linux install. You can either use Disk Utility or use Bootcamp, important thing is, is that you have two partitions (Your MacOS partition and your new linux one) (It isn't recommended that you totally delete MacOS as firmware updates are applied through it).
-
Flash your iso to a USB Stick, If you want a easy way to do this. Use Balena Etcher. For a more command line way of doing this, use dd.
-
Disable MacOS secure boot. Apple's Documentation
a. Turn on your Mac, then press and hold Command (⌘)-R immediately after you see the Apple logo to start up from macOS Recovery.
b. When you see the macOS Utilities window, choose Utilities > Startup Security Utility from the menu bar.
c. When you're asked to authenticate, click Enter macOS Password, then choose an administrator account and enter its password.
d. Set the first option to "No Security", and the second to "Allow booting from External Media".
e. Reboot your Mac.
-
Once Secure boot is diabled, fully shutdown your Computer and Power it on again whilst holding the Option (⌥) key.
-
Select the yellow EFI System using the arrow keys and hit enter.
-
Scroll down to
Boot x86 64 {Your Edition}
using the arrow keys and press enter. -
After booting into Manjaro, open a terminal window and run this command:
systemctl start systemd-timesyncd.service
- Open the installer and proceed normally until you hit the partitioning stage
- Click Manual Partitioning
- Click on
/dev/nvme0n1p1
then press edit at the bottom of the install window, change the Change the Mount Point:/boot
, after that click okay. - Usually, the MacOS partition is mounted to
/dev/nvme0n1p2
(Double check this, the Installer should recognize this partition as anApple APFS
Partition). Ignore the MacOS partition. - Delete the partition you created before, this is usually mounted to
/dev/nvme0n1p3
. - These next steps involve partitioning the
/
(Root) and/home
(Home) partitions of your Linux filesystem, if you know what you are doing feel free to skip to the next step (15).
- Create a
51200 MiB
partition withext4
as the file system. Change the mount point to/
and click okay. - Use the remaining disk space to create an
ext4
file system. Change the mount point to/home
.
- Click Next, on the next screen a warning will appear about EFI System Partition Configuration. Just ignore it and click okay.
- Continue the rest of the setup as normal. Once the installer has finished do not restart the system.
- Open a terminal, and type:
sudo fdisk -l.
The root password is 'manjaro'
- Scroll up to the disk named /dev/nvme0n1. Note down the names of the 50G Linux partition and the 300M EFI SYSTEM partition. In my case these were mounted at /dev/nvme0n1p1 (EFI System) and /dev/nvme0n1p3 (Linux Filesystem).
- Copy this command into a terminal, substitute the two fields in { } with your EFI System and Linux Filesystem names
sudo mount {Linux Filesystem} /mnt; sudo mount {EFI System} /mnt/boot
- Run this command, take note of the UUID (Note this command has a space in the grep command
"/ "
, It is there for a reason)
cat /mnt/etc/fstab | grep "/ "
- Open a new terminal, and run this command
manjaro-chroot /mnt
- Run this command to install systemd-boot
bootctl --path=/boot --no-variables install
- and then this one to mask systemd from not touching a EFI var (Causes a kernel panic)
systemctl mask systemd-boot-system-token.service
- Open the file /boot/loader/entries/manjaro.conf in your favorite text editor (If you are a beginner use the command below)
nano /boot/loader/entries/manjaro.conf
- Paste in the block of text below (Note for beginners to paste into a terminal its usually control + shift + v)
title Manjaro Linux
linux /vmlinuz-5.7-x86_64-mbp
initrd /intel-ucode.img
initrd /initramfs-5.7-x86_64-mbp.img
options root="UUID={change_this_value}" rw
- Change back to your other terminal with the values, And copy the UUID from the other terminal, replacing {change_this_value} (Including the brackets).
- Save the file (Use ctrl+x if you copied my command from above, press the y button and then press enter).
- Run the command below:
echo -e 'default manjaro.conf\rtimeout 4\rconsole-mode max\reditor no' > /boot/loader/loader.conf
- Press control + d
- Run this command:
sudo umount -R /mnt
Reboot your computer, Remembering to move the USB boot flash drive, and welcome to Manjaro :)
In order to get WiFi working
- Boot into OSX and run the following in terminal:
ioreg -l | grep C-4364
It will show something like:
"RequestedFiles" = ({"Firmware"="C-4364__s-B2/kauai.trx","TxCap"="C-4364__s-B2/kauai-X3.txcb","Regulatory"="C-4364__s-B2/kauai-X3.clmb","NVRAM"="C-4364__s-B2/P-kauai-X3_M-HRPN_V-u__m-7.5.txt"})
| | | | "images" = {"C-4364__s-B2/kauai-X3.txcb"={"imagetype"="TxCap","required"=No,"imagename"="C-4364__s-B2/kauai-X3.txcb"},"C-4364__s-B2/P-kauai-X3_M-HRPN_V-u__m-7.5.txt"={"imagetype"="NVRAM","required"=Yes,"imagename"="C-4364__s-B2/P-kauai-X3_M-HRPN_V-u__m-7.5.txt"},"C-4364__s-B2/kauai-X3.clmb"={"imagetype"="Regulatory","required"=Yes,"imagename"="C-4364__s-B2/kauai-X3.clmb"},"C-4364__s-B2/kauai.trx"={"imagetype"="Firmware","required"=Yes,"imagename"="C-4364__s-B2/kauai.trx"}}
It'll be different depending on your exact model.
-
There are three files to note down. A
.trx
(for me:C-4364__s-B2/kauai.trx
), a.clmb
(for me:C-4364__s-B2/kauai-X3.clmb
and a.txt
(for me:C-4364__s-B2/P-kauai-X3_M-HRPN_V-u__m-7.5.txt
-
Look for the corrisponding files in this repository: https://packages.aunali1.com/apple/wifi-fw/18G2022/ (Thank you Aunali1)
-
Boot back into linux and place the files in the following locations:
-
Copy the trx to
/lib/firmware/brcm/brcmfmac4364-pcie.bin
(e.g.sudo cp kauai.trx /lib/firmware/brcm/brcmfmac4364-pcie.bin
) -
The clmb to
/lib/firmware/brcm/brcmfmac4364-pcie.clm_blob
(e.g.sudo cp kauai-X3.clmb /lib/firmware/brcm/brcmfmac4364-pcie.clm_blob
) -
The txt to something like
/lib/firmware/brcm/brcmfmac4364-pcie.Apple Inc.-MacBookPro15,1.txt
. You will need to replace15,1
with your model number. (e.g.sudo cp P-kauai-X3_M-HRPN_V-u__m-7.5.txt /lib/firmware/brcm/brcmfmac4364-pcie.Apple Inc.-MacBookPro15,1.txt
).a. Identifying your MacBook Pro Model or Identifying your MacBook Air Model
- Credit to @mikeeq for the write up.
Footnote - WiFi using iwd (Recommended!)
The way I recommend getting WiFi to work in linux is using iwd instead of wpa_supplicant. Below is how you would configure iwd.
sudo pacman -S iwd
systemctl stop wpa_supplicant
systemctl mask wpa_supplicant
sudo nano /etc/NetworkManager/NetworkManager.conf
paste in this at the end:
[device]
wifi.backend=iwd
Run:
systemctl enable iwd
then reboot.
Footnote - WiFi using wpa_supplicant
In the next release this will not be required, but in order to have the wifi work after reboot run the following commands (NOTE: This is a bit tempremental as wpa_supplicant really doesn't work that well with the chips in the MacBooks):
sudo pacman -S wifi-fix-mbp
systemctl start wifi-fix.service; systemctl enable wifi-fix.service
Useful Packages:
audio-fix-mbp
- Installs files needed for pulseaudio rules
wifi-fix-mbp
- Usage:
systemctl start wifi-fix.service; systemctl enable wifi-fix.service
- Fixes a bug where the wifi firmware won't load on boot
- Usage:
FAQ
Issues Updating Because of the MBP Repository
When you update the system, you may recieve errors about my key being corrupted, if that occurs open a terminal and run this
sudo pacman-key --recv-key 2BA2DFA128BBD111034F7626C7833DB15753380A --keyserver keyserver.ubuntu.com
When I click on the EFI Partition I boot into MacOS!
Yes, sadly I made a mistake in the very early builds. This is because the earlier builds used a different naming scheme before i adopted the manjaro standard of naming the kernel linuxXX-mbp
In order to fix this fire up the live usb again. Once you boot into manjaro mount your EFI partition mount /dev/nvme0n1p1 /mnt
edit the file nano /mnt/loader/entries/manjaro.conf
and chane the line:
linux /vmlinuz-linux56-mbp
to
linux /vmlinuz-5.6-x86_64-mbp
and also change line:
initrd /initramfs-linux56-mbp.img
to
initrd /initramfs-5.6-x86_64-mbp.img
After that try the EFI System partition again.
Note, after your first update with pacman the kernel will revert back to the old names, in order to ensure you still get the latest updates revert these lines back after runing sudo pacman -Syu once.
Switch Touchbar to Function Keys
Run this in your terminal:
sudo bash -c "echo 2 > /sys/class/input/*/device/fnmode"
The Repo doesn't work!
The old repository was on port 8080, this is no longer how I want to move forward and this repo has been taken down and off this port.
In order to switch to the new repository run this in a terminal:
sudo sed -i 's/http:\/\/jacobpyke.xyz:8080/https:\/\/jacobpyke.xyz/' /etc/pacman.conf
Building for yourself
Option 1: Docker - All Linux Distros
First, you need to ensure that docker isn't using overlay
or overlay2
filesystems. This can be verified by running docker info
. And will be shown next to Storage Driver
.
In the event that you are running overlay
, Look at this docker documentation on how to switch to VFS.
Note, this doesn't work on OSX or Windows, I am working closely with the Manjaro Devs on this one.
Quick Docker Install Script - For Linux
sh -c "$(curl -fsSL "https://raw.githubusercontent.com/JPyke3/mbp-manjaro/master/build-in-docker.sh")"
Docker Command
docker run --privileged \
-v ~/manjaro-mbp-iso:/root/out \
-v {PATH-TO-REPO}:/root/iso-profiles\
--env KERNEL=linux57-mbp\
--env EDITION=gnome\
jpyke3/mbp-manjaro-buildiso
Command Breakdown
--privileged
- This is required for allowing the filesystems to be created. (This is a security risk! Read for yourself the documentation on this flag)
-v
- Create a folder on your host filesystem to retrieve the compiled files from the container
- Ensure that
{PATH-TO-REPO}
is replaced by the absolute path to this repo's files.
--env
- There are two environment variables:
KERNEL
: This is used for defining which kernel version to use. All packages will follow the-mbp
naming scheme.EDITION
: This is used for defining which edition of manjaro you would like to install.
- There are two environment variables:
Option 2: Manually on an existing Manjaro Install
First Install Manjaro Tools:
pamac install manjaro-tools-iso git
Clone the repository to your home directory
git clone https://github.com/JPyke3/mbp-manjaro ~/iso-profiles
run a command corrisponding to your preferred version of Manjaro:
buildiso -f -p {edition} -k linux57-mbp
Available Options are:
architect gnome kde nxd xfce awesome bspwm-mate cinnamon i3 lxqt openbox webdad bspwm budgie deepin lxde mate ukui
File Locations
Navigate to the directory for your iso file. If Using a official edition go to:
cd /var/cache/manjaro-tools/iso/manjaro/{NAME_OF_EDITION}/20.0.3/
If using a community edition to:
cd /var/cache/manjaro-tools/iso/community/{NAME_OF_EDITION}/20.0.3/
Known Limitations
Architect / TTY
All TTY's will overscan on these models. This is known and being actively worked on.
Notable Resources
- Build Manjaro ISOs with Buildiso: https://wiki.manjaro.org/Build_Manjaro_ISOs_with_buildiso
- Apple BCE DKMS Git: https://aur.archlinux.org/packages/apple-bce-dkms-git/
- Manjaro Core Packages: https://gitlab.manjaro.org/packages/core
- 2018+ MBP Discord Server: https://discord.gg/fgDd8Vr
- Arch MBP 2018 (Out of Date): https://gist.github.com/TRPB/437f663b545d23cc8a2073253c774be3
Noteworthy Helpers
- Aunali1 (Arch Linux MBP and DKMS Modules): https://github.com/aunali1
- MCMrARM (Original Drivers): https://github.com/MCMrARM
- mikeeq (Fedora Linux MBP): https://github.com/mikeeq
- TRPB (Original Arch Linux Guide): https://github.com/TRPB
- marcosfad (Ubuntu MBP): https://github.com/marcosfad
Noteworthy GitHub Repo's
- Keyboard, Trackpad, Audio and Suspend: https://github.com/MCMrARM/mbp2018-bridge-drv
- Arch Linux Kernel Patches: https://github.com/aunali1/linux-mbp-arch
- DKMS Module for loading Patches: https://github.com/aunali1/apple-bce-arch