GonnaHetzMe/palera1n
1
0 Fork 0
mirror of https://github.com/palera1n/palera1n.git synced 2026-10-23 10:39:48 +02:00
Code Issues Packages Projects Releases Wiki Activity

Make the readme better and port the common issues from the Discord Server to a md doc (#324)

Browse Source 
* port common issues and make readme better

* thanks alexia for the small update for amd

* make table of contents link to actual problems

* Rename commonissues.md to COMMONISSUES.md (per nebula's request)
This commit is contained in:
BananaOnGitHub authored and GitHub committed 2023-01-22 21:45:16 -05:00
1 parent a9a1f775cb
commit efb5ce48c3
3 files changed
+317 -63
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

COMMONISSUES.md
+177
View File
@@ -0,0 +1,177 @@
# Common Issues
- ## Table of Contents
1. [GLIBC not found](#glibc-not-found)
2. ["Booted device" but not booted](#booted-device-but-not-booted)
3. [NewTerm not launching](#newterm-not-launching)
4. [palera1n/mineek repo not working](#palera1n-mineek-repo-not-working)
5. [Procursus "killed 9"](#procursus-killed-9)
6. [App crashes on open](#app-crashes-on-open)
7. ["Killed" issue (not "Killed: 9")](#killed-issue-not-killed-9)
8. [Error while loading shared libraries: libssl.so.1.1](#error-while-loading-shared-libraries-libssl.so.1.1)
9. [Please reinstall Sileo via SSH](#please-reinstall-sileo-via-ssh)
10. [How to fix RocketBootstrap](#how-to-fix-rocketbootstrap)
11. [Loader app not appearing **(most common)**](#loader-app-not-appearing)
12. [Your local changes would be overwritten by checkout](#your-local-changes-would-be-overwritten-by-checkout)
13. [Could not connect to lockdownd](#could-not-connect-to-lockdownd)
14. [Package is in a very bad inconsistent state](#package-is-in-a-very-bad-inconsistent-state)
15. [Error installing bootstrap. Status: -1](#error-installing-bootstrap.-status--1)
16. [jbinit DIED!](#jbinit-died)
17. [Daemons crashing on iOS 16.2+](#daemons-crashing-on-ios-16.2)
18. [Panics making loader not appear](#panics-making-loader-not-appear)
19. [libhooker wants to install?](#libhooker-wants-to-install)
20. [Pressing “install” on each jb (don't do it)](#pressing-install-on-each-jb)
21. [--restorerootfs still keeps app icons??](#restorerootfs-still-keeps-app-icons)
22. [Device boots out of DFU](#device-boots-out-of-dfu)
## GLIBC not found
Add the universe repo by using the command below:
- `sudo apt-add-repository universe && sudo apt update`
Then, try again, and it should be fixed.
## \"Booted device\" but not booted
This may happen when the downloading and patching process is interrupted. Please run `./palera1n.sh clean` (use with `sudo` if on Linux), then try again.
If that doesn't fix it, it may be caused by an update from the Procursus repo. The quickest way to fix it is `./palera1n.sh --restorerootfs`. Alternatively, you can manually restore `/usr/libexec/dirs_cleaner` from the rootfs snapshot using the SSHRD script.
## NewTerm not launching
Install NewTerm 2 from [https://apt.itsnebula.net/](https://apt.itsnebula.net/ "https://apt.itsnebula.net/") or get NewTerm3 beta.
## palera1n\/mineek repo not working
[https://repo.palera.in/](https://repo.palera.in/ "https://repo.palera.in/") and [https://mineek.github.io/repo](https://mineek.github.io/repo "https://mineek.github.io/repo") are supposed to be used on rootless jailbreaks, not with jailbreaks with fakefs or tethered that have root access.
## Procursus \"killed 9\"
Binaries will need to be resigned by the Procursus Team to fix killed 9, in the meantime, use the palera1n strap repo. you can install it from [nebula’s repo](https://apt.itsnebula.net).
## App crashes on open
- `ldid -s /Applications/<appname>.app`
- Don't include the <>
## \"Killed\" issue \(*not* \"Killed: 9\"\)
You ran out of RAM on the Linux Live CD.
Ways to fix the issue, ordered by which to try first:
1. Close some apps, like Discord
2. Attempt a shallow clone, `git clone --depth=1` in place of `git clone`
3. Clone palera1n onto persistent storage[note 1]
4. Install Linux onto your computer.
Note 1: How to use persistent storage from Linux Live, with terminal
1. If you have already cloned palera1n, please delete it! Usually this can be done with `sudo rm -rf ~/palera1n` (assuming palera1n cloned into home directory)
2. You may want to install ntfs-3g first, on Ubuntu this can be done by running `sudo apt install ntfs-3g`
3. Run `sudo lsblk` to list your disks
4. Locate the persistent storage you want to use, for example a Windows C: drive would be of type "ntfs" and at least 10 GB in size, take a note of the device name, which starts with /dev
5. Mount disk onto `/mnt` *(example, please don’t paste as is)*: `sudo mount -t ntfs /dev/sda3 /mnt`
6. Change the working directory into `/mnt`: `cd /mnt`
7. Try to clone palera1n again
Note 2: Most Linux Installers will set up swap areas automatically during the install if you use guided partitioning (if such option exists)
In order to create a 2GB swap area as root:
1. Run `dd if=/dev/zero of=/swapfile bs=1M count=2048`
2. Run `chmod 600 /swapfile`
3. Format by running `mkswap /swapfile`
4. Open /etc/fstab in an editor like `nano`, then add a line that is `/swapfile none swap sw 0 0`
5. Run `swapon /swapfile`
## Error while loading shared libraries: libssl.so.1.1
You can workaround this by installing OpenSSL 1.1 using the command(s) below (on systems with dpkg):
- `curl -LO http://nz2.archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2.16_amd64.deb`
- `sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.16_amd64.deb`
## Please reinstall Sileo via SSH
If you have AutoSign installed and you reinstall/update Sileo, you'll get the error message shown in the screenshot. Here's how to fix it.
1. Get access to a terminal by either using SSH or NewTerm
2. Run `sudo apt remove autosign`. Unless you changed it, the password is `alpine`
3. Once it's done, run `sudo apt reinstall org.coolstar.sileo`
4. Try running Sileo again. Feel free to upgrade it if that was what you were planning to do.
5. Install AutoSign again
It should be fixed after these steps.
Example image:
![image with an error onscreen stating: "Sileo was unable to acquire root permissions. Please reinstall Sileo using SSH."](https://media.discordapp.net/attachments/1028693596469207191/1051879461093650442/1F92489D-5CA5-4E0C-A1FE-CED814FB0089.png?width=244&height=434)
## How to fix RocketBootstrap
1. Remove the Odyssey repo if you have it (to make sure you don't mistakenly install full libhooker, which *does not work* with palera1n)
2. Add the [Havoc repo](https://havoc.app/)
3. Install `libhooker-shim` (if it wants to remove Substitute, you've done something wrong)
4. Get this deb: [https://repo.theodyssey.dev/debs/rocketbootstrap_1.1.0~libhooker2-iphoneos-arm.deb](https://repo.theodyssey.dev/debs/rocketbootstrap_1.1.0~libhooker2-iphoneos-arm.deb "https://repo.theodyssey.dev/debs/rocketbootstrap_1.1.0~libhooker2-iphoneos-arm.deb")
5. Open it in Sileo or Filza, and install it.
6. Reboot userspace (`launchctl reboot userspace`)
**Note**: Some tweaks (e.g. Watusi) are known to not work with this method.
## Loader app not appearing
restorerootfs and rejailbreak with `--restorerootfs` at the end of your previous command. If neither of these help, make sure you're waiting enough time (15-30 seconds).
On iPads, the loader may not show up. You can try to open it using [this shortcut](https://www.icloud.com/shortcuts/8cd5f489c8854ee0ab9ee38f2e62f87d). If other apps don’t appear along side the loader, try installing TrollHelper from [Havoc](https://havoc.app), and install TrollStore.
## Your local changes would be overwritten by checkout
Run the following commands, and then try again:
- `cd ramdisk`
- `git stash`
- `git stash drop`
- `cd ..`
## Could not connect to lockdownd
Try the following steps to fix the issue:
- Unplug and replug your device
- Run `idevicepair pair` (use `sudo` if on Linux)
- Trust the computer on your device if needed
- Run `idevicepair pair` again (use sudo if on Linux)
Alternatively, you can manually [enter recovery mode](https://support.apple.com/en-us/HT201263 "enter recovery mode") before starting palera1n.
## Package is in a very bad inconsistent state
You can fix this by running this command in a terminal:
- `sudo dpkg -r --force-remove-reinstreq <PACKAGE_NAME>`
- Don't include the <>
## Error installing bootstrap. Status: \-1
You're not jailbroken. Sideloading the loader app on its own **will not work**.
Please run the palera1n script on your computer to jailbreak your device.
## jbinit DIED!
Your device may get stuck on a verbose boot screen, and if you look closely you'll see a "jbinit DIED!" error near the top.
The simplest way to fix this is `rm -rf blobs` (use `sudo` if on Linux), then force reboot your device and try to jailbreak again.
**For advanced users**:
You can also try re-copying the `other/rootfs` files manually to the device using SSHRD.
## Daemons crashing on iOS 16.2+
Substitute may cause daemons to crash on iOS 16.2 and above. It's recommended to downgrade to iOS 16.1.2 or below for now. Or you can try using ElleKit instead, but note that some tweaks don't yet work with it.
## Panics making loader not appear
You may be encountering some issue related to panics and the loader “not appearing”, on A10+ make sure you have your passcode **disabled** before jailbreaking.
## libhooker wants to install?
**Remove the Chimera and Odyssey repo immediately!**
These repos are not meant to be used with palera1n and are able to break your jailbreak if you install anything from them.
## Pressing \"install\" on each jb
**DO NOT DO THIS.** It will likely break your jailbreak install. Instead, press the gear icon, and then press Do All.
## --restorerootfs still keeps app icons??
There's an issue with restoring rootfs where it doesn’t uicache. **There is no need to worry**; this happens on a couple of other jailbreaks and serves no harm to the user or device.
Example image:
![image depicting blank icons for apps](https://media.discordapp.net/attachments/1028693596469207191/1065709922207150080/1A4B5107-DCFA-42E6-AC2D-1106CD854FC2.jpg?width=830&height=434)
## Device boots out of DFU
Make sure to use a USB-A cable, and enter recovery mode first before entering DFU (you can use `./palera1n.sh dfuhelper` for this - use `sudo` if on Linux).
<br>
### If none of these solve your issue, please join the [Discord server](https://dsc.gg/palera1n).
README.md
+138 -62
View File
@@ -1,109 +1,185 @@
<h1 align="center">
<img src="https://avatars.githubusercontent.com/u/114239186?s=100&v=4" alt="palera1n logo">
<p>palera1n</p>
<h1 align="center">
<img src="https://avatars.githubusercontent.com/u/114239186?s=100&v=4" alt="palera1n logo">
<p>palera1n</p>
</h1>
<h3 align="center">An iOS 15.0-16.2 work-in-progress, (semi-)tethered checkm8 jailbreak.</h3>
<p align="center">
<strong><a href="CHANGELOG.md">Change Log</a></strong>
•
<strong><a href="https://dsc.gg/palera1n">Discord</a></strong>
•
<strong><a href="https://twitter.com/palera1n">Twitter</a></strong>
<h3 align="center">An iOS 15.0-16.3 work-in-progress, (semi-)tethered checkm8 jailbreak.</h3>
<p align="center">
<strong><a href="CHANGELOG.md">Change Log</a></strong>
•
<strong><a href="https://dsc.gg/palera1n">Discord</a></strong>
•
<strong><a href="https://twitter.com/palera1n">Twitter</a></strong>
</p>
# How does it work?
It boots the device with multiple patches required. On first run, it'll boot a ramdisk which dumps your onboard blob, creates a fakefs (if using semi tethered), installs the loader app, and patches your kernel.
# Issues
### Need help?
If you need help, **please** join our Discord. We disabled issues due to the flood of spam, and difficulty to respond in general. We are much more comfortable on Discord.
It boots the device with multiple patches required. On first run, it'll boot a ramdisk which dumps your onboard blob, creates a fakefs (if using semi-tethered), installs the loader app, and patches your kernel.
Please, please, please, provide necessary info:
# Requirements
- iOS version and device (eg. iPhone 7+ 15.1, iPhone 6s 15.3.1)
- Computer's OS and version (eg. Ubuntu 22.04, macOS 13.0)
- The command you ran
- **Full log from the logs folder**
- A checkm8 vulnerable iOS device on iOS 15 or 16 (A8-A11)
- The device must be on iOS 15.0-16.3
- **palera1n will never work with devices above the iPhone X/A11.** Please stop asking in the Discord, and remember: *this is mainly a developer jailbreak*
- If you want the device to be semi-tethered, **you will need 5-10GB of space** for the fakefs. This means that 16GB devices cannot be semi-tethered
- ### A10 and A11 devices
- On A10 and A11, **you must disable your passcode while in the jailbroken state**.
- On iOS 16 A10+, if you EVER enabled a passcode on 16, you have to reset through the settings app/restore with a computer
- On A10, this can be fixed in the future by implementing blackbird.
- On A11, we don't have a SEP exploit yet.
- In the meantime, we recommend [FakePass](https://repo.alexia.lol/depictions/net.cadoth.fakepass) if you would like a passcode
**DO NOT** harass tweak devs if tweaks don't work. Refer to [here](https://github.com/itsnebulalol/ios15-tweaks) for compatiblity.
- A **USB-A to Lightning cable**
- USB-C cables
- ![USB-C cable why bad explanation](https://media.discordapp.net/attachments/1065789142803435530/1065850603995148298/image.png?width=362&height=433)
You may join [here](https://dsc.gg/palera1n).
# Patreons
Thank you so much to our Patreons that make the future development possible! You may sub [here](https://patreon.com/palera1n), if you'd like to.
<a href="https://github.com/samh06"><img width=64 src="https://user-images.githubusercontent.com/18669106/206333607-881d7ca1-f3bf-4e18-b620-25de0c527315.png"></img></a>
<a href="https://havoc.app"><img width=64 src="https://docs.havoc.app/img/standard_icon.png"></img></a>
<a href="https://twitter.com/yyyyyy_public"><img width=64 src="https://pbs.twimg.com/profile_images/1429332550112079876/dQQgsURc_400x400.jpg"></img></a>
<a href="https://twitter.com/0xSp00kyb0t"><img width=64 src="https://pbs.twimg.com/profile_images/1603601553226620935/1t4yD1bD_400x400.jpg"></img></a>
<a href="https://chariz.com"><img width=64 src="https://chariz.com/img/favicon.png"></img></a>
<a href="https://twitter.com/stars6220"><img width=64 src="https://pbs.twimg.com/profile_images/1606990218925670400/Y4JBl6OS_400x400.jpg"></img></a>
<a href="https://github.com/beast9265"><img width=64 src="https://avatars.githubusercontent.com/u/79794946?v=4"></img></a>
- A Linux or macOS computer
- Python 3 must be installed.
- This must be a **physical computer**. Virtual machines **do not work.**
- AMD CPUs have an issue [with (likely) their USB controllers] that causes them to have a very low success rate with checkm8. It is unrecommended that you use them with palera1n.
- If your device does not successfully jailbreak, try a computer with an Intel or other CPU
# Warning
- We are **NOT** responsible for any data loss. 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 one of the following:**
- futurerestore --exit-recovery
- irecovery -n
# Prerequisites
- A checkm8 vulnerable iOS device on iOS 15 or 16 (A8-A11)
- The device must be on iOS 15.0-16.2
- Linux or macOS computer
- Python 3 must be installed.
### A10 and A11 devices
- On A10 and A11, **you must disable your passcode while in the jailbroken state**.
- On iOS 16 A10+, if you EVER enabled a passcode on 16, you have to reset through the settings app/restore with a computer
- On A10, this can be fixed in the future by implementing blackbird.
- On A11, we don't have a SEP exploit yet.
- 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.
# How to use?
A tutorial can be found [here](https://ios.cfw.guide/installing-palera1n).
# Issues
**Please first check the [common issues](https://github.com/palera1n/palera1n/blob/main/common-issues.md) document.**
## Still need help?
If you still need help, **please** join our Discord. We disabled issues due to the flood of spam, and difficulty to respond in general. We are much more comfortable on Discord.
Please, please, please, provide necessary info:
- iOS version and device (eg. iPhone 6s 15.3.1, iPhone X 16.0)
- Computer's OS and version (eg. Ubuntu 22.04, macOS 13.0)
- The command you ran
- **Full log from the logs folder**
**DO NOT** harass tweak devs if tweaks don't work. Refer to [here](https://github.com/itsnebulalol/ios15-tweaks) for compatiblity.
You may join [here](https://dsc.gg/palera1n).
# Patrons
Thank you so much to our Patrons that make the future development possible! You may sub [here](https://patreon.com/palera1n), if you'd like to.
<a href="https://github.com/samh06"><img width=64 src="https://user-images.githubusercontent.com/18669106/206333607-881d7ca1-f3bf-4e18-b620-25de0c527315.png"></img></a>
<a href="https://havoc.app"><img width=64 src="https://docs.havoc.app/img/standard_icon.png"></img></a>
<a href="https://twitter.com/yyyyyy_public"><img width=64 src="https://pbs.twimg.com/profile_images/1429332550112079876/dQQgsURc_400x400.jpg"></img></a>
<a href="https://twitter.com/0xSp00kyb0t"><img width=64 src="https://pbs.twimg.com/profile_images/1603601553226620935/1t4yD1bD_400x400.jpg"></img></a>
<a href="https://chariz.com"><img width=64 src="https://chariz.com/img/favicon.png"></img></a>
<a href="https://twitter.com/stars6220"><img width=64 src="https://pbs.twimg.com/profile_images/1606990218925670400/Y4JBl6OS_400x400.jpg"></img></a>
<a href="https://github.com/beast9265"><img width=64 src="https://avatars.githubusercontent.com/u/79794946?v=4"></img></a>
# Repos
### Tweaks mode
All repos work when using tweaks mode because it uses normal Procursus and not rootless.
### Rootless
### Rootless
Repos need to be updated for rootless, here are some that work currently:
- [Mineek's repo](https://mineek.github.io/repo) contains rootless Procursus packages
- The official [palera1n repo](https://repo.palera.in) contains miscellaneous packages
If you want to make a rootless repo, use the official [palera1n repo](https://github.com/palera1n/repo) for reference. Every deb should use the `iphoneos-arm64` architecture, and *nothing* should be on the rootfs. Everything should be in /var/jb.
# Credits
- [Nathan](https://github.com/verygenericname)
- The ramdisk that dumps blobs, copies files, and duplicates rootfs is a slimmed down version of [SSHRD_Script](https://github.com/verygenericname/SSHRD_Script)
- For modified [restored_external](https://github.com/verygenericname/sshrd_SSHRD_Script)
- Also helped Mineek getting the kernel up and running and with the patches
- Helping with adding multiple device support
- Fixing issues relating to camera.. etc by switching to fsboot
- [iBoot64Patcher fork](https://github.com/verygenericname/iBoot64Patcher)
- The ramdisk that dumps blobs, copies files, and duplicates rootfs is a slimmed down version of [SSHRD_Script](https://github.com/verygenericname/SSHRD_Script)
- For modified [restored_external](https://github.com/verygenericname/sshrd_SSHRD_Script)
- Also helped Mineek getting the kernel up and running and with the patches
- Helping with adding multiple device support
- Fixing issues relating to camera.. etc by switching to fsboot
- [iBoot64Patcher fork](https://github.com/verygenericname/iBoot64Patcher)
- [Mineek](https://github.com/mineek)
- For the patching and booting commands
- Adding tweak support
- For patchfinders for RELEASE kernels
- [Kernel15Patcher](https://github.com/mineek/PongoOS/tree/iOS15/checkra1n/Kernel15Patcher)
- [Kernel64Patcher](https://github.com/mineek/Kernel64Patcher)
- Work on jbinit, together with [Nick Chan](https://github.com/asdfugil)
- For the patching and booting commands
- Adding tweak support
- For patchfinders for RELEASE kernels
- [Kernel15Patcher](https://github.com/mineek/PongoOS/tree/iOS15/checkra1n/Kernel15Patcher)
- [Kernel64Patcher](https://github.com/mineek/Kernel64Patcher)
- Work on jbinit, together with [Nick Chan](https://github.com/asdfugil)
- [Amy](https://github.com/elihwyma) for the [Pogo](https://github.com/elihwyma/Pogo) app
- [checkra1n](https://github.com/checkra1n) for the base of the kpf
- [nyuszika7h](https://github.com/nyuszika7h) and [Vadim Yegorov](https://github.com/vadim-a-yegorov) for the script to help get into DFU
- [nyuszika7h](https://github.com/nyuszika7h) for the script to help get into DFU
- [the Procursus Team](https://github.com/ProcursusTeam) for the amazing [bootstrap](https://github.com/ProcursusTeam/Procursus)
- [F121](https://github.com/F121Live) for helping test
- [m1sta](https://github.com/m1stadev) for [pyimg4](https://github.com/m1stadev/PyIMG4)
- [tihmstar](https://github.com/tihmstar) for [pzb](https://github.com/tihmstar/partialZipBrowser)/original [iBoot64Patcher](https://github.com/tihmstar/iBoot64Patcher)/original [liboffsetfinder64](https://github.com/tihmstar/liboffsetfinder64)/[img4tool](https://github.com/tihmstar/img4tool)
- [Tom](https://github.com/guacaplushy) for a couple patches and bugfixes
- For maintaining [Kernel64Patcher](https://github.com/palera1n/Kernel64Patcher)
- For maintaining [Kernel64Patcher](https://github.com/palera1n/Kernel64Patcher)
- [xerub](https://github.com/xerub) for [img4lib](https://github.com/xerub/img4lib) and [restored_external](https://github.com/xerub/sshrd) in the ramdisk
- [Cryptic](https://github.com/Cryptiiiic) for [iBoot64Patcher](https://github.com/Cryptiiiic/iBoot64Patcher) fork, and [liboffsetfinder64](https://github.com/Cryptiiiic/liboffsetfinder64) fork
- [libimobiledevice](https://github.com/libimobiledevice) for several tools used in this project (irecovery, ideviceenterrecovery etc), and [nikias](https://github.com/nikias) for keeping it up to date
- [Nick Chan](https://github.com/asdfugil) general help with patches and iBoot payload stuff
- [Dora](https://github.com/dora2-iOS) for iBoot payload and iBootpatcher2
- [Sam Bingner](https://github.com/sbingner) for [Substitute](https://github.com/sbingner/substitute)
- [Serena](https://github.com/SerenaKit) for helping with boot ramdisk.
palera1n.sh
+2 -1
View File
@@ -1075,7 +1075,8 @@ echo "The device should now boot to iOS"
echo "When you unlock the device, it will respring about 30 seconds after"
echo "If this is your first time jailbreaking, open the new palera1n app, then press Install"
echo "Otherwise, press Do All in the settings section of the app"
echo "If you have any issues, please join the Discord server and ask for help: https://dsc.gg/palera1n"
echo "If you have any issues, please first check the common-issues.md document for common issues"
echo "If that list doesn't solve your issue, join the Discord server and ask for help: https://dsc.gg/palera1n"
echo "Enjoy!"
} 2>&1 | tee logs/${log}