Documentation

Dopamine Installation & Usage Guide

A comprehensive guide to jailbreaking your iOS device with Dopamine. Select your experience level below to begin.

Beginner Quick Start Guide

Jailbreaking allows you to customize your iOS device, install tweaks, and bypass restrictions. Dopamine is a rootless jailbreak, meaning it doesn't modify system files, making it incredibly safe and easy to remove.

Before You Start Checklist:

  • Ensure your device is running iOS 15.0 – 17.3.1.
  • Make a full iCloud backup of your device.
  • Remove any passcode/face ID temporarily if you encounter issues during execution (optional).
  • Have a P12 certificate and mobileprovision profile ready (or use a free Apple ID developer signing account).

Installation Steps:

  1. Verify iOS Compatibility

    Navigate to Settings → General → About on your device. Confirm your software version is between 15.0 and 17.3.1.

  2. Get the Dopamine IPA

    Download the latest official Dopamine IPA from our homepage or GitHub. Do not extract or rename the file.

  3. Sign the IPA Online

    Head to our Free Signer page. Upload the Dopamine IPA along with your P12 cert and password. Tap "Sign & Install" to sideload it directly onto your iPhone.

  4. Trust the Developer Profile

    Once installed, go to Settings → General → VPN & Device Management. Find your profile and tap "Trust".

  5. Run the Jailbreak

    Launch the Dopamine app from your home screen and tap the prominent Jailbreak button. Your device will automatically respring.

⚠️ Critical Warning

Never accept official Apple iOS software updates after jailbreaking. Updates will patch the exploits, remove your jailbreak, and could potentially lock your device until a full restore is done.

Tweaks & Package Management

Now that your device is jailbroken, you can install tweaks using package managers like Sileo (pre-installed with Dopamine) or Zebra.

1. Adding Repositories (Sources)

By default, Sileo contains standard repos. To install custom tweaks, you must add developers' repos:

  1. Open Sileo and tap the Sources tab.
  2. Tap the + button in the top right corner.
  3. Paste the repository URL (e.g., https://repo.chariz.com/) and tap Add Source.

2. Top Recommended Dopamine Tweaks

✦ Choicy — Advanced tweak injection configurator. Prevents tweak detection in banking apps.
✦ Snowboard — The ultimate lightweight UI thematic engine. Change icons and status bar themes.
✦ Ampere — Replaces iOS battery percentage UI with custom, sleek telemetry.
✦ Filza File Manager — Complete rootless file browser to view/modify sandbox directories.

3. How to Backup and Re-Jailbreak

Jailbreaks are semi-untethered. If your phone reboots or runs out of battery, the jailbreak is temporarily deactivated. Simply reopen the Dopamine app on your home screen and tap Jailbreak again to reload your tweaks.

Developer & Power User Documentation

Dopamine is built on advanced security exploit chains. As a developer, you can gain deep terminal access and customize low-level launch daemons.

1. SSH Terminal Access

Dopamine installs dropbear SSH automatically. To connect from your PC over Wi-Fi (make sure both are on the same network):

ssh root@<your-iphone-ip> -p 22
# Default password is: alpine

⚠️ Note: Always change your root password immediately using the passwd command to prevent external attacks.

2. Rootless Architecture File Paths

Because the main root partition is write-protected (SSV), Dopamine maps files inside the /var/jb/ virtual link path. Every package and tweak is installed inside this directory structure:

  • Binaries & Executables: /var/jb/usr/bin/ or /var/jb/usr/sbin/
  • Tweaks (.dylib): /var/jb/usr/lib/TweakInject/
  • Preferences: /var/jb/Library/PreferenceBundles/

3. Troubleshooting Common Errors

  • Reboot your device, close all background apps, wait 1 minute, and try clicking Jailbreak again. Expots rely on race conditions which may fail occasionally.
  • This indicates you are in a non-jailbroken state (e.g. after a device reboot). Open the Dopamine app and click Jailbreak to re-enable your tweak injection environment.

Frequently Asked Questions