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 A9(X) and later devices on iOS 15.0 to 16.5, A9(X) to A14 and M1 devices on iOS 16.5.1, and A9(X) to A11 devices on iOS 16.6 to 16.6.1.

TIP

If you're using an A8(X) iPad, at this time, you should follow Installing meowbrek2 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 several 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 follow the subsequent steps.

TIP

If you already have TrollStore installed, you can skip this section.

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. Depending on your device, enter one of the following url's:
  3. 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.

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
    • Sideloadly must make a request to it's servers in order to work with free developer accounts. If you are not OK with this, you may use an alternate Apple ID.

The app will now install to your iOS device.

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.

DANGER

If you're on iOS 16.0 to 16.1.2, 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

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

DANGER

This method can be very unreliable in some cases. If you are having issues with doing these steps, you can follow Installing Dopamine (Sideloadly) instead.

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 TrollMisaka .ipa file into Sideloadly
  4. Enter in your Apple ID
  5. Enter in your password
    • Sideloadly must make a request to it's servers in order to work with free developer accounts. If you are not OK with this, you may use an alternate Apple ID.

The app will now install to your iOS device.

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

Adding a Keyboard

  1. Open TrollMisaka, then exit the app while keeping it in the app switcher
  2. Go to Settings -> General -> Keyboard -> Keyboards -> Add New Keyboard...
  3. Select TrollMisaka
  4. Tap TrollMisaka, then toggle on Allow Full Access, then tap Allow
  5. Re-open TrollMisaka

After re-opening TrollMisaka, open the app switcher and then reboot your device.

DANGER

Do not fully close TrollMisaka until TrollStore is installed, or you will have to redo the entire guide from the beginning.

Injecting TrollStore Helper

WARNING

This method may take several tries in order to work successfully.

  1. Unlock your device
  2. Immediately open Spotlight Search (via swipping down on the middle of the home screen)
  3. Tap the globe icon on the keyboard
    • If needed, select TrollMisaka from the list of keyboards
  4. Tap kopen
    • If the device reboots, try these steps again
  5. Tap Install TrollStore
    • If the keyboard app seemingly refreshes, try again, If it fails, try again in Safari instead.

Once it says it's successful, you can continue with the next section.

Installing TrollStore

  1. Re-open the app switcher
  2. Open the TrollMisaka app from the app switcher
  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

WARNING

This method may have issues in some cases. If you are having repeated issues with this method, you can follow Installing Dopamine (Sideloadly) instead.

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 TrollStar .ipa file into Sideloadly
  4. Enter in your Apple ID
  5. Enter in your password
    • Sideloadly must make a request to it's servers in order to work with free developer accounts. If you are not OK with this, you may use an alternate Apple ID.

The app will now install to your iOS device.

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

DANGER

If you don't have it enabled already, 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

Injecting TrollStore Helper

WARNING

This method may take several tries in order to work successfully.

  1. Open TrollStar
  2. Tap Click here to start!
    • If the device reboots, wait a few minutes, then try again
  3. Tap Install TrollStore Helper to Tips
  4. Tap Respring to Apply

Your device will respring after you tap Respring to Apply.

Installing TrollStore

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

Downloads

The latest version of DopamineOpen in new window

  • Make sure to download the .ipa file onto your iOS device

Installing Dopamine

  1. Open TrollStore if it is not open already
  • If you're in a different tab, go back to the Apps tab
  1. Press the + on the top right
  2. Go to where you saved the Dopamine .ipa file
  3. Tap on the Dopamine .ipa file
  4. 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.

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.