iOS Guide

Installing Odysseyra1n (macOS)

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

Downloads

A screenshot of the checkra1n application

Installing checkra1n

TIP

If you're using an Apple Silicon Mac and are attempting to jailbreak on A7 device or an A9X (not A9) to A10(X) device, you will be prompted during the process to unplug and replug the device and will need to do so.

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.

  1. Open checkra1n on your computer
  2. Plug your iOS device into your computer
    • 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
  3. Click Start -> Next on checkra1n
    • Your device will be put into recovery mode automatically
  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 "homebrew" by pasting and executing the following command: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
  4. Install "iproxy" by pasting and executing the following command: brew install libusbmuxd
  5. 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'