Troubleshooting

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

How to enter DFU mode

For devices with a real home button (iPhone 6s and below):

  1. Hold down both the Home button and Lock button.
  2. After 8 seconds, release the Lock button while continuing to hold down the Home button.

For iPhone 7/7+, iPod 7th Gen and 2018 iPads:

  1. Power on your iPhone/iPad if it's not on already
  2. Connect it to your computer with your cable
  3. Launch iTunes (or Finder on macOS Catalina and newer) and check that the iPhone/iPad is recognised
  4. Hold down both the Side button and Volume Down button.
  5. After 8 seconds, release the Side button while continuing to hold down the Volume Down button.

For devices without a home button, iPhone 8/8+, iPad Air 5 and iPad Mini 6:

  1. Power on your iPhone/iPad if it's not on already
  2. Connect it to your computer with your cable
  3. Launch iTunes (or Finder on macOS Catalina and newer) and check that the iPhone/iPad is recognised
  4. Press the Volume Up button immediately followed by the Volume Down button
  5. Press and hold down the Power button until the screen turns black
  6. Release the Power button
  7. Hold down the Power button and the Volume Down button for immediately after for 5 seconds
  8. Release the Power button but keep holding down the Volume Down button for another 5 seconds

How to exit DFU mode

For devices with a real home button (iPhone 6s and below):

Hold the Home button and the Lock button until the device reboots.

For iPhone 7/7+, iPod 7th Gen and 2018 iPads:

Hold down the Side button and Volume Down button until the device reboots.

For devices without a home button, iPhone 8/8+, iPad Air 5 and iPad Mini 6:

  1. Quick-press the Volume Up button
  2. Quick-press the Volume Down button
  3. Hold down the Side button until the device reboots.

Common Errors on Odyssey and Taurine

ERR_Jailbreak

This is caused by you having used a previous jailbreak. To solve this, you need to restore rootfs:

  1. Reboot the device.
  2. Open the Odyssey or Taurine app, depending on your iOS version.
  3. Toggle the Restore Rootfs option
  4. Press the Jailbreak button.

Once the restore rootfs successfully completes, try jailbreaking again.

ERR_Already_Jailbroken and ERR_KernRW (Taurine)/ERR_TFP0 (Odyssey)

ERR_Already_Jailbroken indicates that the jailbreak process was interrupted. ERR_KernRW and ERR_TFP0 indicate that the exploit failed. Both can be solved in the same way:

  1. Reboot the device.
  2. Open the Odyssey or Taurine app, depending on your iOS version.
  3. Press the Jailbreak button.

TIP

Jailbreaks are hardly ever 100% successful, you may need to re-attempt running the jailbreak multiple times

Common Errors on unc0ver

rootFS already mounted

  1. Open the Settings application
  2. Go to General -> iX Storage
    • This could be iPhone Storage, iPad Storage or iPod Storage
  3. Scroll to the System Update downloaded and tap on it
  4. Tap Delete
  5. Re-run unc0ver

If this doesn't fix it, or there is no update downloaded, you may need to download the OTA update and delete it again. Try the following instructions:

  1. Open the unc0ver application
  2. Tap on the settings icon in the top right-hand corner
  3. Uncheck all the options
  4. Enable Restore RootFS
  5. Press Done in the top right-hand corner
  6. Go to the jailbreak tab and press Restore RootFS
    • If the button says Jailbreak, go back and check to see if Restore RootFS is the only option enabled
  7. When prompted about restoring, tap OK
    • This may take some time
    • If it fails, try again from the beginning
  8. When finished, tap OK again, and your device will restart
  9. Open the Settings application
  10. Go to General -> Software Update
  11. Download the software update but do not install it
  12. Go back to General
  13. Once downloaded, go to iX Storage like before
    • This could be iPhone Storage, iPad Storage or iPod Storage
  14. Scroll to the System Update downloaded and tap on it
  15. Tap Delete
  16. Scroll to the unc0ver application and tap on it
  17. Tap Delete
  18. Install unc0ver again like before but don't run it yet
  19. Turn on Airplane Mode and run the jailbreak now
    • This may take several attempts, keep trying until it works

TIP

If this doesn't work, ask on the r/Jailbreak Discord ServerOpen in new window for support.

Fixing package installation errors on Sileo

For the purposes of this troubleshooting section, we are assuming you are running Sileo on Taurine/Odyssey/Odysseyra1n.

In order to determine which error you are encountering, you will have to tap Show Details in Sileo when you encounter an error with installing or removing a package.

If the fixes below don't help, feel free to ask on the Sileo Discord ServerOpen in new window for support.

Syntax error: "(" unexpected

This error indicates that the developer of the tweak you are trying to install/remove has written the installation/removal script incorrectly. You will need Filza to fix this issue.

Removing the tweak causing this error

  1. Open Filza and navigate to /Library/dpkg/info
  2. Find the .postinst or .postrm file corresponding to the tweak with an error, e.g. com.miro.shortmoji2.postinst would be the file to edit if ShortMoji 2 had an install error or com.miro.shortmoji2.postrm if it had an uninstall error
  3. Tap and hold the file until a menu appears
  4. Tap Open with
  5. Tap Text Editor
  6. Find the first line of the file that says #!/bin/sh
  7. Change sh to bash
  8. Tap Save
  9. Open Sileo
  10. Uninstall the tweak.
    • For paid tweaks, you will need to file a bug report to the developer if you wish to install the tweak.
    • For free tweaks, you should file a bug report to the developer. If you wish to install the tweak immediately, continue with this guide.

Editing the tweak to fix the error (Free tweaks only)

  1. Open ParcilityOpen in new window in Safari on your device
  2. Search for the tweak you wish to install
    • If it does not appear in the search, you will have to wait for the developer to update their tweak
  3. Tap Download
  4. Once the file has finished downloading, tap on the file in Safari's downloads menu
  5. Tap the share button
  6. Tap Save to Filza
  7. Tap Save
  8. Open Filza, it will open to the folder where you downloaded the tweak file
  9. Tap on the tweak you wish to fix
  10. Scroll down and tap Extract
  11. Open the result folder, and navigate to DEBIAN
  12. Repeat steps 2-8 of Removing the tweak causing this error above
  13. Navigate back to the folder where you downloaded the tweak
  14. Tap and hold on the tweak folder
  15. Tap on Create DEB
  16. Tap and hold on the resulting deb file
  17. Tap Open with
  18. Tap on Sileo
  19. Tap Get

TIP

Some developers in the Jailbreak community put a call to the wrong shell in their installation/removal scripts. Until April 2021, most Jailbreaks pointed /bin/sh to /bin/bash so developers were able to use #!/bin/sh to indicate which shell to use even if they use Bash features. In April 2021, Procursus, which runs on Chimera, Odyssey, Taurine, and Odysseyra1n, changed to a different, higher performance shell. This broke these incorrectly formatted scripts.

Exec format error

This error indicates that the developer of the tweak you are trying to install/remove has omitted a key part of the installation/removal script. You will need Filza to fix this issue.

Removing the tweak causing this error

  1. Open Filza and navigate to /Library/dpkg/info
  2. Find the .postinst or .postrm file corresponding to the tweak with an error, e.g. com.miro.shortmoji2.postinst would be the file to edit if ShortMoji 2 had an install error
  3. Tap and hold the file until a menu appears.
  4. Tap Open with
  5. Tap Text Editor
  6. Add a new line to the start of the file that says #!/bin/bash.
  7. Tap Save
  8. Open Sileo
  9. Uninstall the tweak.
  10. Navigate to the Sources tab
  11. Swipe down and refresh your sources
  12. Navigate to the Search tab
  13. Type libiosexec1 into the Search field
  14. Install libiosexec1 by Hayden Seay
  15. Try installing the tweak causing an error again

TIP

In May 2021, Procursus attempted to migrate to a version of dpkg that no longer handles this install error, as developers should have included the #!/bin/sh or #!/bin/bash calls in their scripts. At the time of writing, the lead developer of Procursus has created a patch, libiosexec, that re-adds this error handling. If you still encounter this error, you may not have updated for a while.