You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
marcosfad 26e8e6b32c Update kernel 5.7.15 1 year ago
files Add extra params to kernel and stop blacklisting thunderbolt 2 years ago
.gitignore Working Touchpad and keyboard 2 years ago
.travis.yml Add extra params to kernel and stop blacklisting thunderbolt 2 years ago Create multiple releases 1 year ago Create multiple releases 1 year ago Create multiple releases 1 year ago Create multiple releases 1 year ago Update kernel 5.7.15 1 year ago Update kernel 5.7.15 1 year ago Initial commit 2 years ago


The ISO in from this repo should allow you to install ubuntu without using an external keyboard or mouse on a MacBook Pro. It work in my MacBook Pro 16,1.

Build Status

If this repo helped you in any way, consider inviting a coffee to the people in the credits or me

UBUNTU 20.04 ISO with Apple T2 patches built-in.

Apple T2 drivers are integrated with this iso.

This repo is a rework of the great work done by @mikeeq

I'm using the Kernel from -

Using additional drivers:

Bootloader is configure correctly out of the box. No workaround needed.

Before I begin, what version should I use "mbp" or "mbp-alt"?

The difference between the two is that the mbp-alt includes the kernel with the 2001 Patch from the great Aunali1. This patch made my screen blank, but it helped others to get rid of the blank screen. So, here is a list, with what I know through discord members:

MBP mbp mbp-alt

If your mbp is not listed, please try both version and tell me which one is working for you on the issue Blank screen


  1. Reduce the size of the mac partition in MacOS
  2. Download ISO file from releases.
  3. Copy it to a USB using dd (or gdd if installed over brew):
diskutil list # found which number has the USB
diskutil umountDisk /dev/diskX
sudo gdd bs=4M if=ubuntu-20.04-5.6.10-mbp.iso of=/dev/diskX conv=fdatasync status=progress
  1. Boot in Recovery mode and allow booting unknown OS
  2. Restart and immediately press the option key until the Logo come up
  3. Select "EFI Boot" (the third option was the one that worked for me)
  4. Launch Ubuntu Live
  5. Use Ubiquity to install (just click on it)
  6. Select the options that work for you and use for the partition the following setup:
    • Leave the efi boot as preselected by the installer. Your Mac will keep on working with out problems.
    • Add a ext4 partition and mounted as /boot (1024MB)
    • Add a ext4 partition and monted as / (rest)
  7. Run the installer (In my case it had some problem removing some packages at the end, but this is no real problem)
  8. Shutdown and remove the USB Drive
  9. Start again using the option key. Select the new efi boot.
  10. Enjoy.


# /etc/modprobe.d/hid_apple.conf
options hid_apple swap_fn_leftctrl=1
options hid_apple swap_opt_cmd=1
  • I switch the touchbar to show f* by default. If you like another configuration, change /etc/modprobe.d/apple-tb.conf or remove it.
  • To update grub, run: grub-mkconfig -o /boot/grub/grub.cfg

Update to newer kernels


The easy way:

The live cd includes dkms and will automatically run when a new kernel is installed. You can use dkms status to see it.

The step to install it from scratch would be:

sudo apt install dkms
sudo apt install linux-headers-<mbp-kernel-release>-mbp linux-image-<mbp-kernel-release>-mbp
sudo git clone --branch mbp15 /usr/src/apple-ibridge-0.1
sudo dkms install -m apple-ibridge -v 0.1 -k <mbp-kernel-release>-mbp
modprobe apple-ib-tb
modprobe apple-ib-als
sudo git clone --branch aur /usr/src/apple-bce-0.1
sudo dkms install -m apple-bce -v 0.1 -k <mbp-kernel-release>-mbp
modprobe apple-bce

Another way:

Check to see how it is done.

Know issues

  • Sound is not working after the install. Follow the instructions detailed by @kevineinarsson:
    On MBP 16,1, you might also need to disable realtime scheduling if the above gist doesn't work, because the pulseaudio server might get killed if the realtime budget is exceeded ( Just add realtime-scheduling = no to /etc/pulse/daemon.conf.
  • Wifi is not working for bali (MBP 16,1). I'm using a 10$ usb wifi.
  • Checksum is failing for 2 files: md5sum.txt and /boot/grub/bios.img
  • I'm having troubles shutting down ubuntu. Screen is black but fan keeps on working. I have to force shutdown.

Not working (Following the mikeeq/mbp-fedora)


  • ISO is using gzip initramfs. It would be great to change it lz4
  • Optimize the software installed.

Known issues (Following the mikeeq/mbp-fedora)

  • Kernel/Mac related issues are mentioned in kernel repo
  • 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