iOS Guide

Installing Dopamine (TrollStore)

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

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

Dopamine supports all devices on iOS 15.0 to 15.8.6 and 16.0 to 16.5, A14 and earlier devices and M1 devices on iOS 16.5.1, A11 and earlier devices on iOS 16.6 to 16.6.1, and A9(X) to A11 devices except the 9.7" iPad Pro and iPad 5th Generation on iOS 15.8.7 and 16.7 to 16.7.15.

WARNING

Support for 15.8.7 and 16.7 RC (20H18) is only available through a public beta. You may run into issues on these versions that would not occur on versions supported in the latest release of Dopamine.

DANGER

This guide only works on devices running iOS 15.0 to 16.6.1, as well as iOS 16.7 RC (20H18). If you are on iOS 16.7 or later, you should follow Installing Dopamine instead.

DANGER

if you are currently using rootful palera1n, you need to first Remove rootful palera1n before proceeding.

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.

We will first install TrollStore using one of three methods (depending on your current device and iOS version), and then install Dopamine through TrollStore.

Installing TrollStore

The method that needs to be followed in order to install TrollStore depends on both your device and your current firmware version, select the tab that fits your current firmware version and device 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.

TIP

This section requires a computer.

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

TIP

This section requires a computer.

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

TIP

Unless jailbreaks.app is signed, this section requires a computer.

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.

TIP

Once TrollInstallerX is successfully installed, a computer is no longer required for the remainder of this guide.

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

If you're on iOS 16.0 or later, and did not use 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

Installing TrollStore

  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

Both TrollStore and its persistence helper should now be installed.

TIP

A computer is not required for any steps on this guide.

WARNING

A11 and earlier devices are supported on iOS 15.0 to 15.4.1

A12 and later devices are supported on iOS 15.0 to 15.6.1

Installing TrollHelper

  1. Open Safari
  2. Open this page on your device
    • The url of this page is https://ios.cfw.guide/installing-dopamine
  3. On your device, tap here:
    • If you're unable to access this page, type itms-services://?action=download-manifest&url=https://jailbreaks.app/cdn/plists/TrollHelper.plist into Safari
  4. Tap Install

An app named GTA Car Tracker will now install to your iOS device, this app is TrollHelper, however.

Installing TrollStore

  1. Open the GTA Car Tracker app
  2. Tap Register Persistence Helper
  3. Tap Install TrollStore

The TrollStore application will now install to your iOS device.

TIP

This section requires a computer.

Requirements

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 TrollInstallerMDC .ipa file into PlumeImpactor
  7. Click Install

The app will now install to your iOS device.

TIP

Once TrollInstallerMDC is successfully installed, a computer is no longer required for the remainder of this guide.

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 TrollInstallerMDC application can now be opened from home screen.

Injecting TrollStore Helper

WARNING

If you've already opened Tips, reboot your device before following these steps

  1. Open TrollInstallerMDC
  2. Once it says "Successfully replaced Tips binary", close the TrollInstallerMDC app
    • If it gives an error, close TrollInstallerMDC and re-open it

Installing TrollStore

  1. Open the Tips app
  2. 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 Dopamine

Downloads

Installing Dopamine

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

The Dopamine app will now be installed onto your device.

Running Dopamine

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

TIP

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

WARNING

If your device has a replacement screen, there is a chance (especially if the screen is of low quality) that the touchscreen will not work after userspace rebooting into a jailbroken state. This is not a Dopamine issue, and can only be fixed by getting a better screen replacement.

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

While you are now jailbroken at this point, we need to both update and install some packages so that we're able to both update other packages and have stuff work properly

Installing necessary software

  1. Open the Sileo app
  2. Tap on the "Sources" tab
  3. Tap on the "ElleKit" repository, then tap on "All Categories"
  4. Tap on ElleKit
  5. Tap "Get"
  6. Tap the "Queued" bar at the bottom of the page
  7. Tap "Confirm"
  8. Once finished, tap Restart SpringBoard Later
  9. Go to the "Search" tab
  10. Search for PreferenceLoader
  11. Tap on PreferenceLoader
  12. Tap on "Get"
  13. Tap the "Queued" bar at the bottom of the page
  14. Tap "Confirm"
  15. Once finished, tap Restart SpringBoard

TIP

After doing all the above steps, you may need to reboot and rejailbreak in order for tweak injection to function properly.