iOS Guide

Installing palera1n (Rootful)

For support in English, ask for help on the r/Jailbreak Discord Server.

DANGER

This guide only exists as an archive - we won't be making noticeable changes to this guide in the future if anything happens.

For users who are looking for a maintained palera1n guide - we generally recommend following the normal Installing palera1n guide instead, as it will provide an overall better experience in almost every way compared to using rootful palera1n, and is the general direction that most developers are prioritizing tweak support towards.

If you currently use rootful palera1n, we recommend following this guide to remove rootful palera1n and then Install rootless palera1n

Regardless, if you choose to install or continue to use rootful palera1n, do note that there will likely be less and less support over time given, and that newer tweaks will be less and less likely to support this setup of palera1n.

palera1n is a work-in-progress jailbreak that patches the kernel so you can use Sileo and install tweaks. Currently, palera1n is compatible with A11 (iPhone X) and earlier devices on iOS 15 and later, with some major caveats.

On A11 devices, you must disable your passcode and will not be able to use your passcode, or other SEP functionality, until you boot into a stock iOS state. SEP functionality includes things such as a passcode, Face ID/Touch ID, and Apple Pay.

Additionally, if your device is an A11 device on iOS 16 and you've set a passcode before, you will need to erase all content and settings in order to be able to jailbreak.

WARNING

If you are using an old version of palera1n that was tethered, you'll need to remove palera1n before continuing.

TIP

If you are using Windows, you should follow Using palen1x-rootful instead.

Downloads

The version of palera1nOpen in new window for your OS.

  • macOS users should generally get palera1n-macos-universal
  • Linux users should get whichever version corresponds to the architecture of the computer you're using
    • This will be usually palera1n-linux-x86_64. Choose this one if you're unsure.
    • If you're using a 32-bit computer, choose palera1n-linux-x86.
    • If you're using an ARM computer (e.g. a Raspberry Pi), choose palera1n-linux-armel for 32-bit and palera1n-linux-arm64 for 64-bit.

Installing the jailbreak

Please select your operating system:

Installing palera1n

  1. Enable Full Disk Access for Terminal (this only has to be done once)

    • macOS Monterey and below: System Preferences → Security & Privacy → Privacy → Full Disk Access
    • macOS Ventura and above: System Settings → Privacy & Security → Full Disk Access

    If Terminal does not show up in the list, click the plus icon and select it from Applications → Utilities.

  2. If you are on macOS Monterey 12.2.1 or below, run the following commands (this only has to be done once):

    sudo python -m ensurepip
sudo python -m pip install setuptools xattr==0.6.4

  3. Open a terminal window and cd to the directory that palera1n was downloaded to (usually cd ~/Downloads).

  4. Run sudo mkdir -p /usr/local/bin

  5. Run sudo mv ./palera1n-macos-universal /usr/local/bin/palera1n

    • Replace ./palera1n-macos-universal with whatever version you downloaded

  6. Run sudo xattr -c /usr/local/bin/palera1n

  7. Run sudo chmod +x /usr/local/bin/palera1n

Running palera1n

WARNING

If you are using a USB-C to Lightning cable to do this process, you may run into issues entering into DFU mode

If you do have issues, get a USB-A to Lightning cable and, if necessary, also get a USB-C to USB-A adapter.

TIP

If you're using an Apple Silicon Mac and using a USB-C port to plug your cable/adapter into, you'll need to unplug and replug the device after Checkmate! appears in the logs.

  1. Run palera1n <insert arguments here>
    • 16GB devices should use palera1n -B -f - note that you'll need to have 2-3GB of storage space free.
    • Devices with more than 2-3GB of storage space free but with less than 10-15GB of storage space free also can use palera1n -B -f, but only if they're on iOS 15.
    • Devices which have iOS 16 or have more than 10-15GB of storage space free should use palera1n -c -f
    • Make sure your device is plugged in when entering this command

WARNING

If your device is either:

  • On iOS 15 and does not have at least 2-3GB of storage space free
  • On iOS 16 and does not have at least 10-15GB of storage space free

You won't be able to continue following this guide.

If you cannot free up enough storage to follow this, you can alternatively use rootless palera1n by following Installing palera1n (Rootless) instead.

  1. When ready, press Enter and follow the on screen instructions to enter DFU mode.

Your device should begin to create the FakeFS or BindFS (depending on which command you ran).

  1. Once your device is done creating the FakeFS or BindFS, run palera1n -f

TIP

A9(X) and earlier devices have an issue where they will get stuck midway through this process in pongoOS. To work around this issue, you'll need to do the following:

  1. In the terminal window, press Control + C on your keyboard
  2. Rerun the command that you just ran

You'll need to do this every time you rejailbreak your device as well.

DANGER

If you are trying to use a Virtual Machine software of some sort from Windows (e.g. Virtualbox, VMWare, Windows Subsystem for Linux, etc) you will not succeed with following this guide.

WARNING

If you are using a computer with an AMD Ryzen CPU, you will likely run into issues. If you do run into issues, you should use a Mac or a computer with an Intel CPU to follow this guide.

Installing palera1n

WARNING

If you are using a USB-C to Lightning cable to do this process, you may run into issues entering into DFU mode

If you do have issues, get a USB-A to Lightning cable and, if necessary, also get a USB-C to USB-A adapter.

  1. Open up a terminal window
  2. Run sudo systemctl stop usbmuxd
  3. Run sudo usbmuxd -f -p
  4. Open up a new terminal window and cd to the directory that palera1n was downloaded to (usually cd ~/Downloads).
  5. Run sudo mv ./palera1n-linux-* /usr/bin/palera1n
  6. Run sudo chmod +x /usr/bin/palera1n

Running palera1n

  1. Run sudo palera1n <insert arguments here>
    • 16GB devices should use sudo palera1n -B -f - note that you'll need to have 2-3GB of storage space free.
    • Devices with more than 2-3GB of storage space free but with less than 10-15GB of storage space free also can use sudo palera1n -B -f, but only if they're on iOS 15.
    • Devices which have iOS 16 or have more than 10-15GB of storage space free should use sudo palera1n -c -f
    • Make sure your device is plugged in when entering this command

WARNING

If your device is either:

  • On iOS 15 and does not have at least 2-3GB of storage space free
  • On iOS 16 and does not have at least 10-15GB of storage space free

You won't be able to continue following this guide.

If you cannot free up enough storage to follow this, you should instead use rootless palera1n by following Installing palera1n instead.

  1. When ready, press Enter and follow the on screen instructions to enter DFU mode.

Your device should begin to create the FakeFS or BindFS (depending on the command you ran).

  1. Once your device is done creating the FakeFS or BindFS, run sudo palera1n -f

TIP

A9(X) and earlier devices have an issue where they will get stuck midway through this process in pongoOS. To work around this issue, you'll need to do the following:

  1. In the terminal window, press Control + C on your keyboard
  2. Rerun the command that you just ran

You'll need to do this every time you rejailbreak your device as well.

Once the device boots up, open the palera1n loader app and tap Install. After a bit of time, you'll be prompted to respring and Sileo should be on your home screen.

TIP

To rejailbreak your device, no matter what command you ran above, simply run palera1n -f and then repeat any other applicable steps.


To revert the jailbreak, follow Removing palera1n.