Running postmarketOS on iPhone 7

Thanks to the developers of checkra1n and Corellium I was able to port PostmarketOS to the iPhone 7. Since I was only able to transfer small kernel images to the Phone, I only tested a very minimal PostmarketOS installation, but it is booting :)

Image creation and flashing involves several steps. Lets start with preparing a base image containing PostmarketOS:

pacman -S pmbootstrap
pmbootstrap init
# Work path [/home/onny/.local/var/pmbootstrap]
# Vendor: qemu
# Device codename: aarch64
# Kernel: virt
# User interface: none
pmbootstrap install
pmbootstrap chroot -r 
# use 'apk info' to show installed packages and 'apk del ...' to remove unneeded packages like qemu and linux-kernel
pmbootstrap shutdown

During pmbootstrap init, you can leave most of the defaults as they are. Just select no user interface to avoid large system images.

As you can see above, I’m using the package manager pacman on ArchLinux to install required dependencies. Most of them should be available on other Linux distributions too. If you’re using ArchLinux you can add a custom repository to get some of the tools used in this tutorial:

SigLevel = PackageOptional
Server =

In the next step, we’re going to compile the initramfs image which will contain PostmarketOS. First create the init-script inside the rootfs directory, which is needed by the kernel:

# devtmpfs does not get automounted for initramfs
/bin/mount -t devtmpfs devtmpfs /dev
exec 0</dev/console
exec 1>/dev/console
exec 2>/dev/console
exec /sbin/init "$@"

Now we copy the PostmarketOS rootfs to a temporary directory, apply some permissions and package it into a ramdisk archive:

cp -r .local/var/pmbootstrap/chroot_rootfs_qemu-aarch64 /tmp/initramfs
chown -h -R 0:0 /tmp/initramfs
chown -h -R 1000:1000 /tmp/initramfs/var/run/dbus
chmod 755 /tmp/initramfs/init
mkdir /tmp/initramfs/dev
mknod -m 0622 /tmp/initramfs/dev/console c 5 1
cd /tmp/initramfs
sh -c "find . | cpio  --quiet -o -H newc | gzip -9 > /tmp/ramdisk.cpio.gz"

Some of the commands above require root permissions.

Now we can start building the mainline Linux kernel with the patches made by Corellium to support the iPhone 7. It will also include our custom ramdisk containing PostmarketOS:

pacman -S aarch64-linux-gnu-gcc 
cd /tmp
git clone
cd linux-sandcastle
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-
make hx_h9p_defconfig
cp /tmp/ramdisk.cpio.gz .
make -j4
lzma -z --stdout arch/arm64/boot/Image > arch/arm64/boot/Image.lzma

In the last step we’re going to flash the compiled Linux kernel to the iPhone using the jailbreak-tool checkra1n. You can now connect your iPhone via USB.

Be careful, the following steps are considered safe to use but this is still experimental and could brick your phone. Use it at your own risk!

pacman -S checkra1n-cli git unzip
cd /tmp
git clone
cd projectsandcastle/loader
checkra1n # put phone into dfu
checkra1n -cpE
./load-linux ../linux-sandcastle/arch/arm64/boot/Image.lzma ../linux-sandcastle/dtbpack

Using the first checkra1n command will acquire DFU mode on the iPhone. Follow the steps in the program until DFU mode is reached, than kill the program so that no jailbreak is installed on the phone. The second checkra1n command requires DFU mode and will reboot you’re iPhone into PongoOS. From there we can load the Linux kernel together with the device tree file using the tool load-linux.

I hope this will bring further progress to custom Linux operating systems on Apple devices. There are already experiments with dual booting and partitioning. So maybe it could be possible in the future to get persistent storage on the phone for Linux systems!

Happy flashing :)

Update May 2020: This post got featured on various news sites. (archive), Taiwan (archive), (archive), (archive), (archive), Hackernews (archive) and several more!

💬 Are you interested in our work or have some questions? Join us in our public Signal chat pi crew 👋
🪙 If you like our work or want to supprot us, you can donate MobileCoins to our address.


  1. I wouldn’t call it mainline, that’s a bit misleading. it’s intentianlly based on linux-stable, unlike most development branches based on -next or at least torvalds tree, because the patches are not intended to ever be upstreamed. It’s more an insight into how downstream is born…

Leave a Reply

Your email address will not be published. Required fields are marked *