| description |
|---|
Common issues that users have |
-
- "Booted device" but not booted
- jbinit DIED! (sh)
- Pressing "install" on each jb
- End of central-directory signature not found
- Stuck at waiting for network
- Found the USB handle followed by an error occurred
- pip error: legacy-install-failure
- Permission denied (publickey, password)
- "Killed" issue (not "Killed: 9")
-
- NewTerm not launching
- App crashes on open
- Please reinstall Sileo via SSH
- Loader app not appearing
- Could not connect to lockdownd
- Package is in a very bad inconsistent state
- Error installing bootstrap
- Daemons crashing on iOS 16.2+
- Panics making loader not appear
- libhooker wants to install?
- Restoring rootfs still keeps app icons??
- Device boots out of DFU
- SEP Panic: :skg /skgs
- Cannot download apps from App Store
- Snowboard theming incorrectly
- Filza crashing on launch
- dpkg error: Read-only file system
- Library not loaded: /usr/lib/libSystem.B.dylib
- No space left on device
- Third-party daemons not loading on iOS 16
- RocketBootstrap not working (apps crashing, respring loops)
- Cannot install tweaks - Depends mobilesubstrate
- Decrypting apps on palera1n
- Sileo shows red "Queued" error
- AppSync Unified not working
- Installing Linux without USB
- No such file or directory errors on device
- Sileo error: Didn't find architectures ["iphoneos-arm64"]
- Unable to install TrollStore on rootful
- Hash for Packages.zst invalid
- dyld: Symbol not found - Referenced from /usr/bin/launchctl
- libhooker-configurator
The exact cause depends on the preceding error messages, so send a log. A common cause is trying to use the create fakefs (-c) option when rejailbreaking. You need to remove that option if it's not your first time jailbreaking since last restoring rootfs.
If the device is stuck on the Apple logo, unplug and replug the device.
If the device booted up to normal mode, try jailbreaking again and make sure you entered DFU correctly. Entering DFU straight from normal mode is known to cause issues (at least on A11). You should enter recovery mode first and let palera1n guide you to enter DFU. (This will require a USB-A cable, it won't work with most USB-C cables)
If the device is stuck in recovery mode:
- Make sure you restored rootfs with palera1n.sh if you used tethered before, as palera1n-c does not support creating or booting a tethered setup
- Try exiting recovery mode using
palera1n -n - If it's still recovery looping and you can't exit, your SSV seal is most likely broken. Use the apfs-reseal script to fix it. (This script currently only works fully automatically on macOS. If you're on Linux, join the Discord server and ask
@alexia#0003for guidance.) - As a last resort, try updating in iTunes/Finder, and if that doesn't fix it, restore.
Other things to check:
- Use a USB-A cable, not USB-C (if you have an Apple Silicon Mac, you may need a USB hub rather than a single-cable adapter).
- Start from normal or recovery mode, as going straight to DFU usually causes issues.
- Use a computer with an Intel or Apple Silicon CPU, as AMD has issues.
As a last resort, you can try using the legacy palera1n.sh instead, though do note that doesn't support some features like passcode on A10 or bindfs (you can use tethered instead).
If you are using Rufus, you need to flash palen1x in DD mode, not ISO mode.
If you're stuck at Booting pongoOS or Found Pongo USB mode device:
- Kill the script by pressing Ctrl+C
- Type
exit - Then retry. Don't reboot the device.
This happens happens on A9 and older devices.
If it still doesn't work, you can also try unplugging and replugging the device.
Make sure you created fakeFS/bindFS before jailbreaking with rootful, or else you'll also be stuck on the pongoOS screen.
If there is only one USB Error, you can ignore it.
You are trying to use bindFS on iOS 16, which is not currently supported. If you have enough storage, use fakeFS, otherwise use rootless (very limited tweak support) or palera1n.sh tethered.
palera1n uses the checkm8 BootROM exploit which relies on a hardware vulnerability in the A5-A11 chips. Apple has patched the vulnerability in A12 and newer chips, so it does not and will never work on those devices.
This message shows up regardless of the connected device's type and is safe to ignore. It does not mean palera1n thinks your device is an Apple TV.
- Force reboot the device
- Re-run palera1n with the
-soption (Safe Modein palen1x) - Once the device boots up, press the gear icon in the loader and then press Do All
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 to restore rootfs. Alternatively, you can manually restore /usr/libexec/dirs_cleaner from the rootfs snapshot using the SSHRD script.
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 to rm -rf blobs (use sudo if on Linux), then force reboot your device and try to jailbreak again.
Advanced users can also try re-copying the other/rootfs files manually to the device using SSHRD.
DO NOT DO THIS. It resets your package lists and will likely break your jailbreak install eventually. Instead, press the gear icon, and then press Do All.
If you managed to mess up your jailbreak this way, restore rootfs.
If the error message says palera1n.zip, you are running an outdated version of palera1n and need to update using git pull. If that doesn't work, reclone palera1n by running cd .. && sudo rm -rf palera1n && sudo git clone -b legacy --recursive --depth=1 --shallow-submodules https://github.com/palera1n/palera1n && cd palera1n.
Otherwise, this error most likely indicates a problem with your internet connection, and you simply need to try running palera1n.sh again.
This is usually caused by a network issue.
- Make sure you're on the latest commit (
git pull) - Make sure you can access this site
If you can access it but the script still doesn't work, your network may be unstable or certain outgoing requests may be blocked. If you cannot access it, this may mean that your network is blocking it, or it's currently down.
It may also happen if you're using an AMD CPU. AMD CPUs have an issue [with (likely) their USB controllers] that causes them to have a very low success rate with checkm8.
This will happen if the device is in a bad DFU state, which could randomly happen, or happen if you held the 2nd DFU button for too long (volume down on iPhone X, for example).
Reboot and rerun the script, and make sure to follow the DFU helper exactly, and let go as soon as it says it found the device in DFU.
- Ubuntu/Debian
sudo apt install python3-dev
- Fedora
sudo dnf install python3-devel
- openSUSE
sudo zypper install python3-devel
- macOS
- Install Xcode Command Line Tools using:
xcode-select --install
- If it still doesn't work, try the following command:
ARCHFLAGS="-arch $(uname -m)" python3 -m pip install --compile pyimg4
- Install Xcode Command Line Tools using:
If you get this error while using palera1n.sh:
- Run
./palera1n.sh --clean && rm -rf blobs - Try jailbreaking again.
You ran out of RAM. This most commonly happens on a Linux live USB.
Ways to fix the issue, ordered by which to try first:
- Use palera1n-c or palen1x, it requires much less RAM and shouldn't have such issues
- Close some apps, like Chrome and Discord
- Attempt a shallow clone (git clone --depth=1) (this should have been done by default)
- Clone palera1n onto persistent storage (Note 1)
- Install Linux onto your computer
If there is still not enough RAM:
- Set up a swap area (Note 2) that is at least 2 GB in size, especially for computers with less than 2 GB RAM
- If you have already cloned palera1n, please delete it! Usually this can be done with
sudo rm -rf palera1n - You may want to install ntfs-3g first; on Ubuntu this can be done with
sudo apt install ntfs-3g - Run
sudo lsblkto list your disks - 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. - Mount the disk onto
/mnt(example, please don't paste as is):sudo mount -t ntfs /dev/sda3 /mnt - Change the working directory to /mnt:
cd /mnt - Try to clone palera1n again
Most Linux installers will set it up a swap area automatically during the install if you use guided partitioning (if such an option exists). If it didn't set up one for you, here's how to do it manually:
In order to create a 2 GB swap area as root, run the following commands:
dd if=/dev/zero of=/swapfile bs=1M count=2048chmod 600 /swapfilemkswap /swapfileecho '/swapfile none swap 0 0 | sudo tee -a /etc/fstabswapon /swapfile
Install NewTerm 2 from the palera1n strap repo or NewTerm 3 beta from Chariz. Also make sure to update shell-cmds and system-cmds to the latest version.
Refer to this first.
Otherwise, run this in NewTerm or SSH:
ldid -s /Applications/<appname>.app- Don't include the <>
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.
- Get access to a terminal by either using SSH or NewTerm
- Type
sudo apt remove autosign. Unless you changed it, the password isalpine. - Once it's done, type
sudo apt reinstall org.coolstar.sileo. - Try running Sileo again. Feel free to upgrade it if that was what you were planning to do.
- Install AutoSign again.
It should be fixed after these steps.
Example image:
- Check if this shortcut works
- Check for any panic logs. If there are any, join the Discord server and send them in a support thread or in
#general.
- Send the one with latest log that starts with
panic-fullNOT any other log - The log can be acquired through the iDevice that you are trying to jailbreak.
- Go to
- Settings
- Privacy
- Analytics & Improvements
- Analytics Data
- Go to
- Restore rootfs and rejailbreak.
If none of these help, make sure you're waiting enough time (15-30 seconds).
On iPads if other apps don’t appear along side the loader try installing TrollStore Helper from the Havoc repo and use it to install TrollStore.
Mux error (-8) Unplug and plug your device back in.
Pairing dialog response pending (-19) Accept the prompt to trust the computer on your device.
Invalid HostID (-21)
- Run
idevicepair pair(usesudoif on Linux) - Accept the prompt to trust the computer on your device if needed
- Run
idevicepair pairagain (usesudoon Linux) Alternatively, just enter recovery mode manually before jailbreaking.
This usually shows up when trying to uninstall the package from Sileo or another package manager.
You can fix this by running this command in NewTerm or SSH:
sudo dpkg -r --force-all <BUNDLE_ID>- Don't include the <>
- If you get "
Killed: 9" when trying to remove it:- Run
echo /var/lib/dpkg/info/<BUNDLE_ID>.[ep]* | xargs sudo ldid -s
- Run
- If you get a syntax error when trying to remove it:
sudo sed -i 's,/bin/sh,/usr/bin/env bash,' /var/lib/dpkg/info/<BUNDLE_ID>.[ep]*
- If none of the above commands worked:
- Run
sudo rm -f /var/lib/dpkg/info/<BUNDLE_ID>.[ep]* - Then run
sudo dpkg -r --force-all <BUNDLE_ID>
- Run
As a final resort, if none of these worked, you can restore rootfs and rejailbreak.
Status: -1
You're not jailbroken. Sideloading the loader app on its own will not work.
Please run palera1n on your computer to jailbreak your device.
Status: 5
You didn't restore rootfs before updating iOS. Restore rootfs and then try jailbreaking again.
Older versions of Substitute may cause daemons to constantly crash on iOS 16.2 and above, which may also drain your battery. Make sure to install the latest version from the palera1n strap repo.
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.
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.
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:
Make sure to use a USB-A cable, and then follow one of the methods below to enter DFU.
-
Method 1
- Make sure your device is in normal or recovery mode.
- Connect your device to your computer.
- Run
- palera1n-c
./palera1n -D
- palera1n-sh
./palera1n.sh dfuhelper
- Use
sudoif on Linux.
- palera1n-c
- Follow the on-screen instructions.
-
Method 2
- Power off your device.
- Connect it to your computer or a charger
- Immediately start doing the DFU mode sequence.
This happens due to having a passcode set on A10-A11 devices when jailbreaking (or having previously set a passcode on iOS 16, even if it's currently turned off).
- iOS 15
- Turn off your passcode.
- Try jailbreaking again.
- iOS 16
- Turn off your passcode.
- Backup your device.
- Erase from settings or restore from iTunes/Finder.
- Restore the backup.
- Try jailbreaking again.
On A11, you can use FakePass from https://repo.alexia.lol/ to have a passcode (and Face ID on the iPhone X, no Touch ID support yet), but this will only work in jailbroken state. It can be bypassed by simply rebooting the device.
A10 devices boot using PongoOS, so they will natively support a passcode and Touch ID.
Method 1 Install Choicy from this repo and disable tweak injection into the App Store.
Method 2 Disable tweak injection globally in the Substitute app and respring. You can re-enable it after downloading the apps you wanted.
Method 3 Install "Not a bypass" from this repo, open the app it installs, enable the bypass, install the app(s) you want and then disable the bypass.
You may be encountering an issue with Snowboard not theming correctly or not theming at all. To fix this, make sure you have Snowboard from SparkDev's repo to solve these issues.
Example image:
Install Filza File Manager 64-bit from the TIGI Software repo. The version on BigBoss is outdated. You do not need AutoSign or FilzaFixer anymore.
- Open the palera1n loader app.
- Press the gear icon.
- Remount R/W.
- Then try again.
This usually means the fakefs wasn't created properly. It might be left over from a restore. Restore rootfs and try jailbreaking again.
This means that either your iDevice or your computer does not have enough storage.
If you're live booting Linux and have a low amount of RAM, this could be the cause. Please close some programs to make more space in RAM. This would be the case if you get this error before the ramdisk boots (before the 6+ progress bars). If you're using semi-tethered and have less than 10GB available on the iDevice, this may be the issue. Please restore rootfs and clear some space on your device. Alternatively, on palera1n-c, you can create a bindfs that's about 2-3GB, however some paths that are rarely written to are read only. Usually if this is the issue, the console is spammed many times with "No space left on device" or "File or directory not found."
There is a bug in launchctl that causes the loader to fail to load third-party daemons (SSH, Frida, etc.) on iOS 16.
Instructions:
- Make sure to update launchctl from Sileo, as earlier versions had another bug that didn't allow services to load at all.
- If the step above doesn't fix it, run this command in NewTerm:
sudo launchctl load /Library/LaunchDaemons/*.plist
RocketBootstrap does not work as-is on iOS 15 and above, and may cause apps to crash or even respring loops, especially if installed together with Cephei. To fix this, follow the steps below.
iOS 15.0–16.2
- Uninstall any existing version of RocketBootstrap you have installed
- Remove the Odyssey repo if you have it
- Install RocketBootstrap and RocketBootstrapFix from the palera1n strap repo.
iOS 16.3+
- Remove the Odyssey repo if you have it (to make sure you don't mistakenly install full libhooker, which does not work with palera1n)
- Add the Havoc repo
- Install libhooker-shim
- If it wants to remove Substitute, you've done something wrong)
- Get this deb: https://repo.theodyssey.dev/debs/rocketbootstrap_1.1.0~libhooker2-iphoneos-arm.deb
- Open it in Sileo or Filza and install it.
- Reboot userspace (
launchctl reboot userspace)
Note: Some tweaks (e.g. Watusi) are known to not work with the Odyssey version of RocketBootstrap.
Install Substitute from the palera1n strap repo.
Alternatively, you can use ElleKit, but note that some tweaks don't yet work with it.
Most app decryption tools do not currently work on palera1n; however this one is known to work but note that it requires a computer: https://github.com/AloneMonkey/frida-ios-dump
- Run
sudo dpkg -a --configure. - Run
sudo apt install -f. - Then force close and reopen Sileo.
Make sure to install the latest version from Karen's repo, as the one on BigBoss may be outdated.
If you're still having issues, just use TrollStore instead. You can install TrollStore Helper from Havoc.
If you are on Windows and do not have a USB flash drive to live boot or install Linux from, you can use Wubi to dual boot Ubuntu on your computer and use palera1n from there.
Make sure to disable Secure Boot from BIOS/UEFI setup before installing Wubi. (If the option to disable it is greyed out, you may need to set an administrator/supervisor password first.)
Please note that if something goes wrong it may be hard to recover your computer without a USB, though usually it should be recoverable from BIOS/UEFI setup.
You can download Wubi here.
If you get a bunch of "No such file or directory" errors on a verbose screen on your device while jailbreaking with palera1n, it means you don't have enough storage left on your device. FakeFS requires about 10 GB free. Restore rootfs and free up some space or try using bindFS instead, which only uses about 3 GB.
You are using rootless, which doesn't support most tweaks; they will have to be updated.
If you didn't mean to use rootless, it's possible you accidentally jailbroke with palera1n-c without the -f option at some point, or a buggy tweak created /var/jb for you. In that case, try fixing it using the rootless removal shortcut. (You'll have to enable Settings → Shortcuts → Advanced → Allow Running Scripts.)
As a last resort, restore rootfs and pay attention to make sure you're jailbreaking with rootful and not rootless.
Go to the Havoc repo in Sileo, select TrollStore Helper from there, and use swipe actions to install it. Alternatively, manually download and install the .deb.
This is an issue with the repo you're using, and there's nothing you can do as a user to fix it (other than using a different package manager such as Zebra).
It may be caused by Cloudflare's cache, in which case wait up to 4 hours and try again, or ask the repo maintainer to clear the cache.
Remove the Hephaestus/Ironside repo temporarily and downgrade launchctl to 1:1.1.1.
palera1n does NOT support libhooker. Please use Choicy instead of libhooker-configurator as they do the same thing.