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.
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.
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.
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.
Installing via Misaka
Combine the Misaka file manager with a kernel exploit. Primarily for arm64e devices on iOS 16.2–16.6.
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.
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.
Suggested reading order
- Look up your version range and chip architecture in the compatibility table
- Open the matching installation guide and read it end to end before starting
- Once installed, set up the persistence helper immediately
- 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.