iOS Guide

Installing nathanlr

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

DANGER

Before continuing, please read the following information below in full.

nathanlr is what is considered a semi-jailbreak, and is not a full-fledged, proper jailbreak.

Semi-jailbreaks - while allowing you to use a decent percentage of tweaks - do not have the same capabilities as a full-fledged jailbreak. You may run into some tweaks (such as some that inject into daemons) that do not fully work as intended.

DANGER

If you have previously used Serotonin and/or Bootstrap, you will need to remove them fully before proceeding.

If you don't know what Bootstrap or Serotonin are, you can ignore this notice and proceed.

nathanlr is a semi-untethered semi-jailbreak, meaning it requires an app to re-apply the exploit after a reboot.

The tool is capable of semi-jailbreaking A12 and later devices on iOS/iPadOS versions 16.5.1 to 16.6.1, 16.7 RC (20H18), and 17.0.

We will first install TrollStore using one of three methods (depending on your iOS version and computer platform), and then install nathanlr through TrollStore.

Installing TrollStore

The method that needs to be followed in order to install TrollStore depends on your current firmware version and your platform, select the tab that fits your current firmware version and follow the subsequent steps.

TIP

If you already have TrollStore installed, you will not need a computer for any of the subsequent steps, and you can skip this section.

Requirements

TrollInstallerX is currently signed at jailbreaks.app for easy installation without a computer.

Installing the application

  1. Plug your iOS device into your computer
    • Make sure your computer is trusted and allowed to view the contents of your device
  2. Open PlumeImpactor
  3. Go to Settings -> Sign In
  4. Enter in your Apple Account and Password
  5. Close the Settings and Sign In windows
  6. Drag and drop the TrollInstallerX .ipa file into PlumeImpactor
  7. Click Install

The app will now install to your iOS device.

Trusting the application

  1. Go to Settings -> General -> Device Management -> <Your Apple Account>
    • Depending on your usage, Device Management may be labeled Profiles and Device Management
  2. Tap Trust "<Your Apple Account>"

The TrollInstallerX application can now be opened from home screen.

DANGER

Unless you used jailbreaks.app to install TrollInstallerX, you'll also need to enable Developer Mode.

To do so, go into Settings -> Privacy & Security and then scroll down until you see Developer Mode, tap that option, toggle Developer Mode on, and follow the on-screen instructions

Running TrollInstallerX

  1. Open TrollInstallerX
  2. Tap Install TrollStore
    • If your device is stuck on "Exploiting Kernel", reboot your device
  3. When prompted to select an app to install the persistence helper into, select an app you care about the least
    • If you don't know what app to select, select Tips
    • If your device reboots before getting to this step, try again

The persistence helper should now be installed into the app you selected.

Installing TrollStore

WARNING

If the persistence helper is not installed into the app you selected, shut down your device normally, turn your device back on, open the app you want as your persistence helper, then close the app (from the app switcher) and run TrollInstallerX again.

  1. Open the app you selected as your persistence helper from your home screen
  2. Press Install TrollStore.

TrollStore will now be installed to your device.

Requirements

WARNING

Before continuing, if you're using macOS, extract the contents of the downloaded TrollRestore .zip file.

WARNING

As this method of installing TrollStore involves restoring a modified backup, you'll need to disable Find My before continuing with this guide.

After this guide is complete, you are free to re-enable Find My.

WARNING

The build of TrollRestore for Intel-based Macs is not notarized, which means you'll either need to Double Click while holding Control (if on macOS Sonoma or earlier) or by attempting to open it normally, and then opening System Settings -> Privacy & Security and scrolling down until you see Open Anyway.

Injecting TrollStore Helper

  1. Plug your iOS device into your computer.
    • Make sure your computer is trusted and allowed to view the contents of your device
  2. Open a File Explorer (Windows) or Finder (macOS) window.
  3. Navigate to where the downloaded/extracted file is saved.
    • This will likely be the Downloads folder.
  4. Double Click TrollRestore.
  5. When prompted, type in the name of a system app you want to overwrite, and press enter.
    • If you are unsure as to what app you want to overwrite, overwrite the Tips app by entering Tips

TIP

Until the device reboots, there is no visual indication on the device itself that anything is being done.

The TrollStore Helper should now be restored to your device, and your device will reboot once this process is complete.

Installing TrollStore

  1. Unlock your device.
  2. Open the app you originally put in.
  3. Tap Install TrollStore

Your device should respring, and TrollStore should now be installed.

Installing Persistence Helper

  1. Open the TrollStore app on your home screen
  2. Press Settings, then press Install Persistence Helper
  3. Select Tips from the list of apps

Requirements

WARNING

Before continuing, extract the contents of the downloaded TrollRestore .zip file.

WARNING

As this method of installing TrollStore involves restoring a modified backup, you'll need to disable Find My before continuing with this guide.

After this guide is complete, you are free to re-enable Find My.

TIP

While this tab (and the associated zip file) are for Linux platforms, all other platforms can follow this tab and use the Linux .zip file as an alternative to the normal executable files.

Installing Dependencies

  1. Open a terminal application
  2. Run cd <path/to/TrollRestore>
    • In most cases, this will likely mean running cd ~/Downloads/TrollRestore_Linux
  3. Run pip3 install -r requirements.txt and follow the on screen prompts

All dependencies needed for TrollRestore should now be installed.

Injecting TrollStore Helper

  1. Plug your iOS device into your computer
    • Make sure your computer is trusted and allowed to view the contents of your device
  2. In the same terminal window as the previous section, run python3 trollstore.py
  3. When prompted, type in the name of a system app you want to overwrite, and press enter.
    • If you are unsure as to what app you want to overwrite, overwrite the Tips app by entering Tips

TIP

Until the device reboots, there is no visual indication on the device itself that anything is being done.

The TrollStore Helper should now be restored to your device, and your device will reboot once this process is complete.

Installing TrollStore

  1. Unlock your device.
  2. Open the app you originally put in.
  3. Tap Install TrollStore

Your device should respring, and TrollStore should now be installed.

Installing Persistence Helper

  1. Open the TrollStore app on your home screen
  2. Press Settings, then press Install Persistence Helper
  3. Select Tips from the list of apps

Installing nathanlr

Downloads

Installing nathanlr

  1. Open TrollStore
  2. Press the + on the top right
  3. Go to where you saved the nathanlr .tipa file
  4. Tap on the nathanlr .tipa file
  5. Tap Install

The nathanlr app will now be installed onto your device.

Running nathanlr

  1. Reboot your phone
    • This is not necessary but recommended
  2. Open the nathanlr application from your home screen immediately afterwards
  3. Tap "Bootstrap", then tap "Jailbreak"

TIP

If the app or your device crashes/restarts unexpectedly and nathanlr isn't installed, simply try rebooting and running the exploit again until it does work.

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

Updating packages

  1. Open the Sileo application
  2. Tap on the "Packages" tab
  3. Tap "Upgrade All"
  4. Tap "Confirm"