iOS Guide

Installing Dopamine

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 16.5, A14 and earlier devices and M1 devices on iOS 16.5.1, and A11 and earlier devices on iOS 16.6 to 16.6.1.

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 two 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.

DANGER

If you do not already have TrollStore installed, and are using an A8(X) iPad on firmware version 15.7.2 or later, you need to follow Installing Dopamine (Sideloadly) instead.

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. Open Sideloadly
  2. Plug your iOS device into your computer
    • Make sure your computer is trusted and allowed to view the contents of your device
  3. Drag and drop the TrollInstallerX .ipa file into Sideloadly
  4. Enter in your Apple ID
  5. Enter in your password

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 ID>
    • Depending on your usage, Device Management may be labeled Profiles and Device Management
  2. Tap Trust "<Your Apple ID>"

The TrollInstallerX application can now be opened from home screen.

DANGER

If you're on iOS 16.0 to 16.6.1, 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. Open Sideloadly
  2. Plug your iOS device into your computer
    • Make sure your computer is trusted and allowed to view the contents of your device
  3. Drag and drop the TrollInstallerMDC .ipa file into Sideloadly
  4. Enter in your Apple ID
  5. Enter in your password

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 ID>
    • Depending on your usage, Device Management may be labeled Profiles and Device Management
  2. Tap Trust "<Your Apple ID>"

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.