This page contains tips on installing Arch Linux on a Mid 2010 13" MacBook Pro alongside a pre-existing OSX operating system.
Install Boot Manager
Optional. The easiest way to begin is by installing rEFInd on Mac OSX before moving on to Arch. This will place a boot menu on startup. The config will be in your OSX partition - if this is not desirable it is possible to install it later in Arch. Keep in mind that since Apple's OS X 10.11 (El Capitan), the feature System Integrity Protection (SIP) doesn't allow for rEFInd installation in the way described on the Installing rEFInd page. See this site for more information and installation instructions.
Shrinking Macintosh HD
Using Mac OSX's disk utility, create a new partition, calculate the amount of free space required for all new partitions and shrink Macintosh HD to accommodate for this amount. Leave the new partition as free space for now.
EFI vs CSM mode
It's probably good to consider on forehand what the differences are and which will work best for you, especially considering the drawback EFI mode has on the NVIDIA driver.
To install an x86_64 system, follow the Mac EFI installation instructions. It is recommended to read the UEFI, GPT and Arch boot process#Boot loader pages before trying any of this on your machine. Also of note, GIST.
See notes on video support before attempting installation!
The following assumes that you have somehow managed to install archlinux to a single partition on your drive, and that you still have your osx installation on a different partition.
I've found it easiest to install rEFInd from osx. Depending on your setup, you'll either install it to your osx partition, or to the ESP partition (install.sh --esp). See here for instructions. Installing to the ESP partition can cause some startup delay, which can be overcome by simply renaming rEFInd's installation folder to "BOOT" and the executable to "bootx64.efi"
Assuming that rEFInd was installed to the ESP, I've found it convenient to later mount the ESP as my "/boot" directory. That way, by setting
in your refind.conf, rEFInd will automatically pickup the kernel. All you need to add is a "refind_linux.conf" file to the root of the ESP, containing your boot args. I use:
"Boot with defaults" "root=/dev/sda3 rootfstype=xfs ro add_efi_memmap"
Note that my root partion is sda3 and that I use the xfs filesystem on it, yours may differ! So my ESP partition looks like this when mounted under "/boot":
EFI/ APPLE/ BOOT/ bootx64.efi drivers/ icons/ keys/ refind.conf initramfs-linux-fallback.img initramfs-linux.img refind_linux.conf vmlinuz-linux
Note that the EFI/BOOT directory is normally named EFI/REFIND and that the bootx64.efi is normally named refind_x64.efi.
You should now be able to boot your mac in efi-mode via the kernel's efistub feature. rEFInd should present you with an option to do so. See here for more general information on the topic. This however has some drawbacks, as mentioned in the Video section below.
Booting your mac in csm- or legacy-mode provides a solution. To do so, we need a hybrid mbr, with at least one 'active/bootable' partition. See here for more general information on how to setup a hybrid mbr. Simply boot in efi-mode, then assuming you have three partitions, the ESP partition, an osx and a linux partition you'll need to use gdisk to set things up.
# gdisk /dev/sda
Press 'p' to print your partition table, which should look somewhat like mine:
Number Start (sector) End (sector) Size Code Name 1 40 409639 200.0 MiB 0700 EFI System Partition 2 409640 393186215 187.3 GiB AF00 OSX 3 393186216 625142414 110.6 GiB 8300 Linux filesystem
Press 'r' to enter recovery and transformation mode.
Now press 'o' to print your mbr. It should only list a single partition covering the entire disk. Or depending on with which tools you used to partition your disk maybe some other entries.
Press 'h' to create a new hybrid mbr. You'll be prompted for some input:
Type from one to three GPT partition numbers, separated by spaces, to be added to the hybrid MBR, in sequence:
I chose to mirror my gpt, so I entered '1 2 3', but it should be enough to just use one partition here. In my example, this would need to be the ESP partition, so '1', but in case you don't want to use the ESP to store your kernels, this could also be the linux partition, so '3'. You decide :)
Another and maybe more secure way to mirror the gpt is only to enter '1' for the first and only partition, the EFI or boot partition. This prevents the strange behaviour of MacOS. It can happen that MacOS or its bootsystem can't find his partition and will end up in a rather long loop. Then proceed as written below.
Make sure to say 'Yes' to the next promt:
Place EFI GPT (0xEE) partition first in MBR (good for GRUB)? (Y/N): y
Then set at least one partition as active/bootable:
Creating entry for GPT partition #1 (MBR partition #2) Enter an MBR hex code (default 07): Set the bootable flag? (Y/N): y
Note the MBR hex code depends on the partition type, press 'l' in gdisk's main menu to list them.
Press 'o' (make sure you're still in the recovery menu!!!) again to see your new hybrid mbr, in my case:
Number Boot Start Sector End Sector Status Code 1 1 39 primary 0xEE 2 * 40 409639 primary 0x07 3 409640 393186215 primary 0xAF 4 393186216 625142414 primary 0x83
Or if you choose to only mirror the first one, it can also look like this:
Number Boot Start Sector End Sector Status Code 1 1 39 primary 0xEE 2 * 40 409639 primary 0xEF
Even if the mbr table looks like this (note that in the second table only the last two lines are missing), the bootloader will know what to boot. You can compare start and end sectors between the two tables if you wish.
Press 'w' to write the table to disk and reboot.
Can't find root device
If booting fails, first try to use the initramfs-linux-fallback.img, as it includes more modules than your 'auto-detected' initramfs, and should allow the kernel to actually find your root partition. You'll then need to rebuild your regular initramfs. Rebuild it with
# mkinitcpio -p linux
If you're lucky, the whole booting process with the regular initramfs-linux will end up successfully, if not, then try to add the following configuration and rebuild the initramfs again. I needed to include modules in the initramfs file. In /etc/mkinitcpio.conf:
MODULES="ata_generic libata xfs"
Note, that you'll only need xfs if your root partition is actually formatted with it, exchange it with the appropriate module for the file-system you use.
Once you reboot, rEFInd should now present you with three options, two linux entries and one for osx. One linux entry will boot the kernel via efistub in efi-mode, the other will call syslinux(or your chosen bootloader) which then should boot the system in csm-mode. Do the latter from now on!
The easiest way to see if you were successful, is to install the NVIDIA driver and start X.
$ lspci -vnn -d 14e4:
If from this you discover that your full PCI-ID is
[14e4:432b], then the following advice applies to you: Don't waste time on the
b43 driver. I've been fiddling with it for weeks, and switching to
broadcom-wl made all the problems go away.
broadcom-wl might make your device names funky, but that's easily fixed with the udev rule documented on Broadcom Wireless.
I also recommend
As of kernel version 3.17.1-2, Broadcom Wireless driver most likely won't work (ERROR @wl_cfg80211_scan :WLC_SCAN error (-22)). The only option seems to be loading the b43 driver in PIO mode. To enable PIO mode, install driver by following the guide at wireless.kernel.org[dead link 2020-02-25], then load the b43 kernel module with pio=1 and qos=0 parameters. To make this happen at boot, create
b43-firmware.conf file in
/etc/modprobe.d/ and add the following lines:
options b43 pio=1 qos=0 blacklist wl blacklist brcmsmac blacklist brcmfmac blacklist b43legacy blacklist bcm43xx blacklist brcm80211
Although using PIO should be much slower than using DMA, I haven't noticed any performance drop. Further testing showed repetitive occurrences of noticable performance drops. Mostly expressed as rapid decrease of transfer speed, sometimes even dropped connections. It also seems that b43 driver has issues operating at 5Ghz.
Some later kernels are giving me more success (without PIO), but still some wifi drops have occurred.
Consult Nouveau for general info on the driver. Works out of the box, performance however is not that great and your system will get quite hot when running nouveau. Will cause issues in electron based applications! Fix by adding --disable-gpu to the .shortcut!
Running the drivers in efi-mode requires setting some PCI registers before the kernel modules get loaded, preferably using a udev hook or GRUB script. You can also use a efi shell script in REFind as stated here. Otherwise, the screen just remains black when X starts. Follow these instructions in order to find the appropriate PCI device IDs for which to set the registers. This approach has been confirmed to work and is still being actively discussed inside the above mentioned thread. The latest NVIDIA drivers are no longer supported for this MacBook's GPU you will instead need to use these ones AUR! Once installed create a config by running the command:
That will automatically generate a config for xorg (/etc/X11/xorg.conf). After that's done you will need to fix the fonts in your current DE/Window manager settings or by editing the xorg config!
When using Nvidia drivers, you can useAUR to get controls in /sys/class/backlight/nvidia_backlight.
For controlling the fans I recommend using mbpfan from the AUR (AUR), reasons being is that from my experience fan control isn't very great on Arch Linux by default and fans always run really loud without this package! Once you install that from the AUR add it to startup!
# systemctl enable mbpfan.service
In Linux kernel 5.1 (or was it 5.2?) the MacBook Pro 7,1 started having audio issues. I have yet to find a fix even though I've been looking for months. If anyone has a fix please edit this section with your fix in it. For now the temporary fix is just rolling back the kernel to Linux 4.19. To do that we need the Linux-LTS package:
Fixed since 5.4.6!
:Install the packages and .
If you are using grub you need to regenerate your grub config, otherwise reconfigure your bootloader to point to /boot/vmlinuz-linux-lts.
For XFCE use cases:
If you have issues with rebooting/power off function with XFCE power manager, add acpi=force to GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub.
Older versions of XFCE power manager will break backlight key handling if you select "handle display brightness keys" after installing nvidia driver (even after re-adding "RegistryDwords" "EnableBrightnessControl=1" to /usr/share/X11/xorg.conf.d/10-nvidia-brightness.conf)
The PCI bridge values (prior to installing nvidia drivers) should be manually set in /etc/grub.d/01_enable_vga.conf