Guides

Installation methods branch strictly by iOS version — there is no universal method. Use the compatibility table to establish which case you are in, then read only the matching guide. Mixing steps from different versions is the most common cause of failure.

English write-ups are in progress. The procedures themselves are version-specific and language-independent, but we would rather publish a proper English article than a rushed translation. Until then, each card below links to the Chinese guide and is marked as such. Compatibility, download and FAQ pages are fully in English.

Check compatibility first →

Pick the method for your version

These four are the main installation write-ups. Confirm which one applies to you in the compatibility table, then read only that one.

Installing via TrollHelper

Install TrollStore Helper through a package manager. Required for jailbroken arm64 devices, and for some models after iOS 15.7.2 that have no non-jailbreak path.

中文 · Chinese · iOS 14.0 – 16.6.1 / 17.0 · arm64 (A8–A11) · requires a jailbroken device

Installing via TrollHelperOTA

Use the system OTA update flow to install the helper. No computer and no jailbreak required — the least effort path on older iOS versions.

中文 · Chinese · iOS 14.0 – 15.6.1 · arm64e (A12 and later) / some arm64

Installing via TrollInstallerMDC

Uses an MDC-class exploit installer. Covers the mainstream iOS 15.5–16.1.2 range with a short procedure and a high success rate.

中文 · Chinese · iOS 15.5 – 16.1.2 · arm64 / arm64e

Installing via Misaka

Combine the Misaka file manager with a kernel exploit. Primarily for arm64e devices on iOS 16.2–16.6.

中文 · Chinese · iOS 16.2 – 16.6 · arm64e (A12 and later)

After installing

Installing is not the end of it. These two cover the problems that show up during long-term use.

Configuring and Recovering the Persistence Helper

Why installed apps stop opening after a reboot, and how to fix it: bind the persistence helper to a built-in system app.

中文 · Chinese · All methods on iOS 15.0 and later · All architectures

Updating and Migrating

Upgrade through the OTA mechanism, plus what to watch out for when switching devices or restoring, and the correct order for migrating data.

中文 · Chinese · Devices with TrollStore already installed · All architectures

Suggested reading order

  1. Look up your version range and chip architecture in the compatibility table
  2. Open the matching installation guide and read it end to end before starting
  3. Once installed, set up the persistence helper immediately
  4. If you later need to upgrade, follow the updating guide

Any procedure that modifies the system can fail. Back up the device fully beforehand, using a computer rather than iCloud alone. This site documents steps; it does not take responsibility for the outcome.