Skip to main content

Offline IPA decryption

This preview covers the two offline commands documented below. It can decrypt an existing licensed IPA using matching local authorization. It does not sign in to an account or download apps. Use an offline-IPA release build for Apple Silicon with macOS 26 or later, or select the static Linux build matching your machine's architecture: arm64 or x86-64.

On macOS, run the export command as your normal user from an interactive terminal. The command requests sudo approval for its own short-lived helper; do not run the whole command with sudo.

ipsw macho export-auth

The export creates ~/.config/ipsw/fairplay/authorization.fpauth; pass --output DIR to use another directory. The directory must be owned by you with mode 0700; the authorization file has mode 0600. An existing authorization file is never overwritten. Treat this file as private account authorization and transfer it only to a machine you control. After copying it, restore the permissions as its owner:

chmod 700 ~/.config/ipsw/fairplay
chmod 600 ~/.config/ipsw/fairplay/authorization.fpauth

On macOS or Linux, provide an IPA whose license matches the exported authorization. The authorization is read from ~/.config/ipsw/fairplay/authorization.fpauth unless you pass --auth FILE:

ipsw macho decrypt-ipa licensedApp.ipa --output ./decrypted

Successful decryption writes decrypted/repacked.ipa; the input IPA is preserved. Decrypting into the same directory again replaces the earlier result. A "matching license record was not found" error means the exported authorization does not contain the license record required by that IPA. Decryption does not replace the app's signing or provisioning requirements and does not make the result installable on an arbitrary device.