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).

Download Provenance

  1. First, download a Release or Prerelease of Provenance (unless using AltStore, direct source download link in AltStore insructions).

  2. Choose a sideloading method:

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: Lightning → USB-A / USB-C cable¹

    • Apple TV 4: USB-C → USB-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+. ³ If using a virtual machine, you may need to configure your network settings.

Sideloading from 3rd party sources is not supported.

💢 If you get stuck, check out Troubleshooting.

iOS App Signer

  1. Download and launch iOS App Signer.

  2. Select .ipa file and resign it to yourself, selecting the Provenance Bundle ID you've used in the past if you 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.

  3. 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).

  4. 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.

  5. On device: Go to Settings → General → Profiles & Device Management, tap on your certificate and then Trust

  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.

AltDeploy

  1. Download and launch AltDeploy.

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

  3. Select your device in Impactor.

  4. Drag & drop .ipa file onto Impactor.

  5. Enter your Apple ID.

  6. 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 AltDeploy, verbatim.

  7. 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.

  8. On device: Go to Settings → General → Profiles & Device Management, tap on your certificate and then Trust

  9. 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.

AltStore

AltStore source is availble at this link Click in Mobile Safari once you have AltStore installed.

  1. Download and launch AltStore.

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

  3. …Follow instructions via altstore.io and the app as it guides you.

  4. You'll need to put Provenance .ipa in your iCloud Drive somewhere and install via AltStore app by using the + button in the upper left of the My Apps screen to select and sideload it to your device.

…Full walkthrough coming later, but it's pretty straight forward as is. Windows AltStore is considered beta and has not been tested by Provenance team yet. Feel free to give it a try.

Free Apple developer provisioning expires every 7 days, requiring reloading (which AltStore can keep track of and handle for you). Re-sideloading to renew will not cause you to 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 to 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.

PreviousInstalling ProvenanceNextBuilding from Source

Last updated