palera1n logo
## Information - Guides to palera1n can be found [here](https://ios.cfw.guide/installing-palera1n). - Full documentation can be also found [here](https://cdn.nickchan.lol/palera1n/artifacts/c-rewrite/palera1n.1.html). ## Warnings - We are **NOT** responsible for any data loss, or the result of a device being bricked. The user of this program accepts responsibility should something happen to their device. While nothing should happen, jailbreaking has risks in itself. - If your device is stuck in recovery, please run futurerestore `--exit-recovery`, or use `irecovery -n`. - palera1n will never work in VirtualBox, VMware or any virtual machine that doesn't support PCI passthrough. ## Requirements - A checkm8 vulnerable iOS device on iOS 15.x or 16.x (`A8` - `A11`) - If using rootful, you will need **5-10GB of space** for the fakefs. This means 16GB devices cannot use the full fakefs creation. However, you can change the arguments to `-Bf` to create a fakefs with bind mounts, so it uses a smaller size, at the expense having unwritable parts in rarely-written paths, and then boot it - On `A11`, **you must disable your passcode while in the jailbroken state** (on iOS 16, you need to **reset your device** before proceeding with palera1n). - **USB-A** cables are recommended to use, USB-C may have issues with palera1n and getting into DFU mode.
Technical explanationThe BootROM will only enter DFU if it detects USB voltage, which boils down to checking whether a certain pin is asserted from the Tristar chip. The Tristar does this based on the cable's accessory ID, and apparently USB-A and USB-C cables have different accessory IDs, and the one of the USB-C cables makes the Tristar not assert the USB voltage pin.
- A Linux or macOS computer - AMD CPUs (not AMD Mobile) have an issue [with (likely) their USB controllers] that causes them to have a very low success rate with checkm8. It is not recommended that you use them with palera1n. - If your device does not successfully jailbreak, try a computer with an Intel or other CPU - Apple Silicon Macs with USB-C - USB-C port on Apple Silicon Macs may require manual unplugging and replugging of the lightning cable after checkm8 exploit. - This problem may be solved by connecting via USBHub. ## Need help? Make sure you provide full details on your device, such as: - iDevice - iOS Version - Passcode enabled? - Logs, if panicked then send latest `panic-full` log from your iDevice. Using `-VvL` would help with debugging. Join the [Support Discord](https://dsc.gg/palera1n), and create a thread in [#support](https://discord.com/channels/1028398973452570725/1028730487700738130) or ask in [#general](https://discord.com/channels/1028398973452570725/1028398976640229380). ## Credits
Credits

- [Lakhan Lothiyi](https://github.com/llsc12) for older palera1n loader app - [checkra1n](https://github.com/checkra1n) for the base of the kpf - [the Procursus Team](https://github.com/ProcursusTeam) for the amazing [bootstrap](https://github.com/ProcursusTeam/Procursus) - [Évelyne](https://github.com/evelyneee) for [ElleKit](https://github.com/evelyneee/ellekit), rootless tweak injection - [Sam Bingner](https://github.com/sbingner) for [Substitute](https://github.com/sbingner/substitute), rootful tweak injection


Thank you so much to our Patreons that make the future development possible! You may sub here, if you'd like to.