Sideloading

Easy. Install pre-built releases (or pre-releases).

Prebuilt .ipa releases can sideloaded onto your devices and must be re-signed using your own developer profile(s).

Sideloading Options:

Requirements

  • Free Apple Developer account (at a minimum) or a paid account.

    🛑 DO NOT enroll to join the full Developer Program or you will be locked into a Pending payment state, unable to code-sign unless you pay or contact Apple to cancel the enrollment.

  • Connections:

    • iPhone / iPad:   LightningUSB-A / USB-C cable¹

    • Apple TV 4:      USB-CUSB-A / USB-C cable¹

    • Apple TV 4K:    WiFi² (Instructions)

¹ Depends on which ports you have. WiFi can be setup after. ² USB ports have been discontinued on Apple TV 4K+.

Sideloading from 3rd party sources is not supported.

💢 If you get stuck, check out Troubleshooting.

Cydia Impactor

  1. Download a Release or Pre-Release of Provenance. Pre-Release build server is not working but the last [somewhat stable] prebuilt files are still reachable here…

  2. Download and launch Cydia Impactor.

  3. Connect your device (you may need to launch iTunes and choose Trust… when it pops up).

  4. Select your device in Impactor.

  5. Drag & drop .ipa file onto Impactor.

  6. Enter your Apple ID.

  7. If not using 2-Factor Authentication, enter your account password, otherwise…

    1. (If you haven't yet), login to your Apple ID online and Generate an App-Specific Password, under Security section (and write it down somewhere for later use).

    2. Enter your App-Specific Password in Cydia Impactor, verbatim.

    ⚠️ If it fails to verify code signature, try resigning the .ipa with…

    • Web: appsigner.io (free devs only)

    • macOS (only): iOS App Signer —return to step 5. 🆔 Bundle ID: com.[change-this].provenance Replace [change-this] with something unique like your username.

    🚸 If Impactor still fails, try Option 2 (macOS only).

  8. On device: Go to SettingsGeneralProfiles & Device Management, tap on your certificate and then Trust

  9. Done. (If using a free developer account, repeat from step 3 after it expires in 7 days)

Free Apple developer provisioning expires every 7 days, requiring reloading, but you will not lose any data.

Paid Apple Developer provisioning may only require re-signing once a year.

iOS App Signer

  1. Download a Release or Pre-Release of Provenance.

  2. Download and launch iOS App Signer.

  3. Select .ipa file and resign it to yourself, selecting the Provenance Bundle ID you've used in the past if you have one already have one. If you don't have one, try creating one here if it lets you or proceed to step 4 and return to this. 🆔 Bundle ID: com.[change-this].provenance Replace [change-this] with something unique like your username.

  4. Connect your device. ⚠️If you haven't yet, register your device to your Apple ID in Xcode. Easiest way to do this is to make dummy app in Xcode and have it automatically create the provisioning when you enter your Bundle ID (Example).

  5. Install:

    • Xcode: Window → Devices and Simulators: Select your device. Drop the new .ipa file onto Installed Apps.

    • Configurator: Double-click your device → Apps: Drop the new .ipa file here.

  6. Done. (If using a free developer account, repeat from step 4 after it expires in 7 days)

Free Apple developer provisioning expires every 7 days, requiring reloading, but you will not lose any data.

💢 Troubleshooting

Cannot authenticate

  • If using 2-Factor Authentication, you will need to go to Apple ID settings and make a key and save it for use in Cydia Impactor, type it verbatim.

Unable to code-sign / install…

  • If you are using a free Apple developer account, you can only install a total of 3 apps per Apple ID at a time. You must use delete some apps you are signing, or install with different Apple ID and Bundle IDs.

  • If you used to have a free Safari Developer Account which is no longer supported by Apple, you have two options:

    1) Upgrade to a paid Apple Developer account.

    2) Use a different Apple ID that is not an expired and deprecated Safari Developer account.

—application-identifier entitlement does not match…

  • This means you need to match the Bundle IDs with the ones from your previous sideload or build on your device. If you don't know it, or used a 3rd party web-sign (unsupported), we recommend you backup your files, delete the app and try to clean-install.

Your maximum App ID limit has been reached…

  • You have made too many Bundle IDs (App IDs) in one week on a free Apple developer account. Stop making new Bundle IDs and revert to one you already made. You are chasing the wrong problem. If all else fails, use a different Apple ID, and make only one new, unique Bundle ID with it (and save it for later when you need to re-sign in 7 days).

Duplicate app

  • If app installs or updates as a duplicate app instead of updating existing installation, you need delete it and use the same Bundle ID as your original build or you'll end up with a double installation…

🗯 If you are still stuck ask for help on our Discord.