iOS Guide

Installing Odysseyra1n (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.

WARNING

A7 devices will likely fail to successfully jailbreak with checkra1n on Linux, as a result, you'll need to use an older checkra1n version and quickly unplug and replug your device once you see Right Before Trigger. It is highly recommended to follow Installing Chimera instead.

Downloads (Linux)

A screenshot of the checkra1n application

Installing checkra1n

TIP

checkra1n provides native support to machines running a Debian-based distro (e.g Ubuntu). It's recommended that you follow specific instructionsOpen in new window provided by the checkra1n team themselves.

  1. Run the checkra1n binary in the terminal using ./checkra1n
    • You may need to run sudo chmod a+x ./checkra1n if the binary doesn't run
    • If you're on an A11 device, you will need to head into Options, then enable the Skip A11 BPR Check option once it runs
    • If you're on iOS 14.6 or later, you will need to head into Options, then enable the Allow Untested Versions option once it runs
    • If you're on an A8X or A9X device and are on iOS 14.4 to 14.4.2, you will need to head into Options, then enable the Allow Untested Versions option once it runs
  2. Click Start and follow all onscreen prompts
  3. 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
  4. 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'