iOS Guide

Installing Odysseyra1n (A8X/A9X) (Linux)

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

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.) this guide will not work, and you should follow Using Odysseyn1x instead.

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.

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.

Downloads (Linux)

A screenshot of the checkra1n application

Installing checkra1n

  1. Open the pongoOS.zip file, navigate to PongoConsolidated.bin, then extract it.
    • Keep note of where you extract this
  2. Run the checkra1n binary in CLI mode using this custom pongoOS in the terminal using sudo checkra1n -c -k [path to PongoConsolidated.bin]
  3. Plug your iOS device into your computer
  4. You will now be presented with instructions in how to reboot your device into DFU mode, click Start to begin
    • Follow the instructions until your device shows a black screen
  5. After this, checkra1n should automatically install

Your iOS device should now reboot.

TIP

While you could, at this stage, install Cydia instead of continuing with the Odysseyra1n steps, we don't recommend it because of the fact that:

  • People generally tend to have more stability when using Odysseyra1n instead of installing Cydia
  • Certain ease-of-use functionality (such as shshd, which automatically saves blobs for you when jailbroken) is not available
  • Some tweaks may require or be better tested with software that Odysseyra1n utilizes, rather than the software that is used when you choose to install Cydia

To install Odysseyra1n, do not open the checkra1n app and install Cydia. Instead, follow the following instructions to install Sileo.

The Odysseyra1n script

TIP

If you would prefer to do so, instead of running the script on your computer, you can run the Odysseyra1n script using the shortcutOpen in new window by opening this page on your device and then clicking the shortcut hyperlink.

  1. Open the terminal app on your computer
  2. Ensure that your computer is trusted by your device
  3. Install "iproxy" by pasting and executing the following command:
    • Ubuntu/Debian: sudo apt install libusbmuxd-tools
    • Arch Linux: pacman -S libusbmuxd
  4. Install the Odysseyra1n script by pasting and executing the following command: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/coolstar/Odyssey-bootstrap/master/procursus-deploy-linux-macos.sh)"

You should now be jailbroken with Sileo installed on your home screen. You can use Sileo to install tweaks, themes, packages and more.

Before you can start installing anything else, you first need to install a few necessary programs.

Installing packages

  1. Open the newly installed Sileo application
  2. Go to the "Packages" tab
  3. Tap "Upgrade All" if there are any updates
    • Do not install yet
  4. Go to the "Search" tab
  5. Search for the "libhooker" package
  6. Tap the "Get" button
  7. Tap on the "Queued" bar at the bottom of your screen
  8. Tap "Confirm"
  9. Once finished, tap 'Restart SpringBoard'