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

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 either follow Installing Dopamine (TrollRestore) or Installing Dopamine (Sideloadly) instead.

TrollInstallerX (A9(X) and later 15.7 to 16.6.1 / A9(X) to A11 15.5 to 15.6.1)

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.

• The latest version of Sideloadly
• The latest version of iTunes if on Windows.
• The latest version of TrollInstallerX
  • If you are using a Yellow iPhone 14 or Yellow iPhone 14 Plus on 16.3 (20D50), you will need the TrollInstallerX-20D50 version instead.

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.

TrollHelperOTA (15.0 to 15.4.1 / A12 and later 15.5 to 15.6.1)

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.

TrollInstallerMDC (A8(X) 15.5 to 15.7.1)

TIP

This section requires a computer.

Requirements

• The Tips app installed to your device
• The latest version of Sideloadly
• The latest version of iTunes if on Windows.
• The latest version of TrollInstallerMDC

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

• The latest version of Dopamine
  • A12 and later devices on iOS 15 are recommended to download the 2.1.7 version of Dopamine instead
  • Make sure to download the .ipa file onto your iOS device

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.