Skip to content
Switch branches/tags

Latest commit

* Fedora 36 release

* Fix kernel installation

* new kernel

* Test build on newer version of Fedora docker image

* Revert "Test build on newer version of Fedora docker image"

This reverts commit 38ea0ed.

* Add some screenshots

* Add some info

* Add some info v2

Git stats


Failed to load latest commit information.


Build Status

Fedora ISO with Apple T2 patches built-in (Macbooks produced >= 2018).

All available Apple T2 drivers are integrated with this iso. Most things work, besides those mentioned in not working section.

Kernel -


Tested on: Macbook Pro 15,2 13" 2019 i5 TouchBar Z0WQ000AR MV972ZE/A/R1 && Macbook Pro 16,2 13" 2020 i5

Boot ROM Version: (iBridge: 16.16.6571.0.0,0)
macOS Mojave: 10.14.6 (18G103)

How to install

  • Turn off secure boot and allow booting from external media -

  • Download .iso from releases section -

  • Next you can check the SHA256 checksum of extracted .ISO to verify if your extraction process went well

    • MacOS: shasum -a 256 livecd-fedora-mbp.iso
    • Linux sha256sum livecd-fedora-mbp.iso
    • please compare it with a value in sha256 file available in github releases
  • Burn the image on USB stick >=8GB via:

    • Fedora Media Writer
    • dd
      • Linux sudo dd bs=4M if=/home/user/Downloads/livecd-fedora-mbp-201908181858.iso of=/dev/sdc conv=fdatasync status=progress
      • MacOS
        • try to find under which /dev/ your USB stick is available sudo diskutil list

        • check if any partitions from it are mounted df -h, if they are please unmount sudo diskutil unmount /dev/disk2s1

        • exec sudo dd if=/Users/user/Downloads/livecd-fedora-mbp-201908181858.iso of=/dev/disk2 bs=4m

        • if dd is not working for you for some reason you can try to install gdd via brew and use GNU dd command instead sudo gdd bs=4M if=/Users/user/Downloads/livecd-fedora-mbp-201908181858.iso of=/dev/disk2 conv=fdatasync status=progress

          # To install gdd via brew, execute
          brew install coreutils
        • don't worry if dd command execution is slow on MacOS, it can take a while due to XNU's poor I/O performance

    • Rufus (GPT)-, if prompted use DD mode
    • Please don't use livecd-iso-to-disk as it's overwriting ISO default grub settings and Fedora will not boot correctly!
  • Install Fedora

    • First of all I recommend to shrink (resize) macOS APFS partition and not removing macOS installation entirely from your MacBook, because it's the only way to keep your device up-to-date. macOS OS updates also contains security patches to EFI/Apple T2

    • Boot Fedora Installer from USB drive directly from macOS boot manager. (You can boot into it by pressing and holding Option key (ALT key) after clicking the power-on button when your computer was turned off or on restart/reboot when Apple logo is shown on the screen).

      • There will be two/three boot options available, usually the last one works for me. (There are multiple boot options, because there are three different partitions in the ISO to make the ISO bootable on different set of computers: 1) ISO9660: with installer data, 2) fat32, 3) hfs+)
    • I recommend using standard partition layout during partitioning your Disk in Anaconda (Fedora Installer) as I haven't tested other scenarios yet. <#2

      • please create a separate partition for Linux EFI (Linux HFS+ ESP) as Anaconda installer requires separate partition on Mac devices and it'll be reformated to EFI (FAT32) during post-install scripts Anaconda's step (at the end of installation process).
        /boot/efi - 1024MB Linux HFS+ ESP
        /boot - 1024MB EXT4
        / - xxxGB EXT4

      anaconda partitioning

    • There will be an error on Installing bootloader... step, click Yes - It's related to efi=noruntime kernel arg

      bootloader issue

      # /tmp/anaconda.log
      13:39:49,173 INF bootloader.grub2: used boot args: resume=UUID=8a64abbd-b1a3-4d4a-85c3-b73800e46a1e rhgb quiet
      13:39:54,649 ERR bootloader.installation: bootloader.write failed: Failed to set new efi boot target. This is most likely a kernel or firmware bug.
  • To install additional languages (only English is available out of the box), install appropriate langpack via dnf dnf search langpacks, i.e.: to install Polish language pack execute: dnf install langpacks-pl

  • After login you can update kernel by running sudo update_kernel_mbp, more info here:

  • You can change mappings of ctrl, option keys (PC keyboard mappings) by creating /etc/modprobe.d/hid_apple.conf file and recreating grub config. All available modifications could be found here:

    # /etc/modprobe.d/hid_apple.conf
    options hid_apple swap_fn_leftctrl=1
    options hid_apple swap_opt_cmd=1
    sudo -i
    # Refresh grub and dracut config by executing update_kernel_mbp script
  • To change function key mappings for models with touchbar see modinfo apple_ib_tb and use echo 2 > /sys/class/input/*/device/fnmode instead of the hid_apple options. See this issue

  • Setup wifi and other model specific devices by following guides on -

How to upgrade current mbp-fedora installations

# Docs:
sudo -i

# Upgrade kernel beforehand
## update_kernel_mbp has built-in selfupgrade function, so when it fails it's just due to script update - please rerun everything should be good on second run
KERNEL_VERSION="5.17.6-f36" UPDATE_SCRIPT_BRANCH="v5.17-f36" update_kernel_mbp

# Upgrade your OS
dnf upgrade -y --refresh
dnf install -y dnf-plugin-system-upgrade

# Exclude official kernel from upgrade to not override mbp-fedora-kernel
## If you're trying to upgrade older version of mbp-fedora to latest version, please repeat a process by upgrading only to one major release of Fedora, i.e.: Fedora 33 -> 34, 34 -> 35, 35 -> 36

FEDORA_VERSION=36 dnf system-upgrade download -y --releasever=${FEDORA_VERSION} --exclude='kernel*'

# Reboot your Mac
dnf system-upgrade reboot

# After reboot clean old packages
dnf clean packages

## or clean all dnf cache
dnf clean all

Not working

  • Dynamic audio input/output change (on connecting/disconnecting headphones jack)
  • TouchID - (@MCMrARM is working on it - Dunedan/mbp-2016-linux#71 (comment))
  • Microphone (it's recognised with new apple t2 sound driver, but there is a low mic volume amp)


  • add Fedora icon to usb installer

  • alsa/pulseaudio config

    • Dynamic audio input/output change (on connecting/disconnecting headphones jack)
    ## to fix pipewire configs on current mbp-fedora installations
    sudo -i
    curl -Ls -o /usr/share/alsa-card-profile/mixer/profile-sets/apple-t2.conf
    curl -Ls -o /usr/lib/udev/rules.d/91-pulseaudio-custom.rules
    ## if you're using MBP16,1 please apply those commands
    sudo -i
    curl -Ls -o /usr/share/alsa/cards/AppleT2.conf
    curl -Ls -o /usr/share/alsa-card-profile/mixer/profile-sets/apple-t2.conf
    curl -Ls -o /usr/lib/udev/rules.d/91-pulseaudio-custom.rules
    ## to manually change audio profile via PulseAudio cli execute
    # to headphones output
    pactl set-card-profile $(pactl list cards | grep -B10 "Apple T2 Audio" | head -n1 | cut -d "#" -f2) output:codec-output+input:codec-input
    # to speakers output
    pactl set-card-profile $(pactl list cards | grep -B10 "Apple T2 Audio" | head -n1 | cut -d "#" -f2) output:builtin-speaker+input:builtin-mic
    ## to manually adjust built-in mic volume
    pactl set-source-volume $(pactl list sources | grep -B3 "Built-in Mic" | head -n1 | cut -d"#" -f2) 300000
  • disable iBridge network interface (awkward internal Ethernet device?)

  • disable not working camera device

    • there are two video devices (web cameras) initialized/discovered, don't know why yet

      ➜ ls -l /sys/class/video4linux/
      total 0
      lrwxrwxrwx. 1 root root 0 Aug 23 15:14 video0 -> ../../devices/pci0000:00/0000:00:1d.4/0000:02:00.1/bce/bce/bce-vhci/usb7/7-2/7-2:1.0/video4linux/video0
      lrwxrwxrwx. 1 root root 0 Aug 23 15:14 video1 -> ../../devices/pci0000:00/0000:00:1d.4/0000:02:00.1/bce/bce/bce-vhci/usb7/7-2/7-2:1.0/video4linux/video1
      ➜ cat /sys/class/video4linux/*/dev
  • verify brcmf_chip_tcm_rambase returns

Known issues

  • Kernel/Mac related issues are mentioned in kernel repo
  • Anaconda sometimes could not finish installation process and it's freezing on Network Configuration step, probably due to iBridge internal network interface

workaround - it's a final step of installation, just reboot your Mac (installation is completed)

  • Macbooks with Apple T2 can't boot EFI binaries from HFS+ formatted ESP - only FAT32 (FAT32 have to be labelled as msftdata).

workaround applied - HFS+ ESP is reformatted to FAT32 in post-scripts step and labelled as msftdata

  • efibootmgr write command freezes Mac (it's executed in Anaconda during Install bootloader... step) - nvram is blocked from writing

    • since macOS Catalina EFI is blocked even from reading, so access to EFI is blocked via adding efi=noruntime to kernel args

      efibootmgr --c -w -L Fedora /d /dev/nvme0n1 -p 3 -l \EFI\fedora\shimx64.efi
  • ctrl+x is not working in GRUB, so if you are trying to change kernel parameters - start your OS by clicking ctrl+shift+f10 on external keyboard





  • @MCMrARM - thanks for all RE work
  • @ozbenh - thanks for submitting NVME patch
  • @roadrunner2 - thanks for SPI (touchbar) driver
  • @aunali1 - thanks for ArchLinux Kernel CI
  • @ppaulweber - thanks for keyboard and Macbook Air patches