Sideloading
Easy. Install pre-built releases (or pre-releases).
Last updated
Was this helpful?
Easy. Install pre-built releases (or pre-releases).
Last updated
Was this helpful?
Prebuilt .ipa releases can sideloaded onto your devices and must be re-signed using your own developer profile(s).
First, download a or Prerelease of Provenance (unless using AltStore, direct source download link in AltStore insructions).
Choose a sideloading method:
❇️ · macOS/Window)
🖋 · macOS + Xcode or Configurator
🧪 · macOS
Requirements
Free 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
² ()³
¹ Depends on which 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 .
Sideloading from 3rd party sources is not supported.
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.
Install:
On device: Go to Settings
→ General
→ Profiles & Device Management
, tap on your certificate and then Trust
Done. (If using a free developer account, repeat from step 4 after it expires in 7 days)
Connect your device (you may need to launch iTunes and choose Trust…
when it pops up).
Select your device in Impactor.
Drag & drop .ipa
file onto Impactor.
Enter your Apple ID.
If not using 2-Factor Authentication, enter your account password, otherwise…
Enter your App-Specific Password in AltDeploy, verbatim.
Install:
On device: Go to Settings
→ General
→ Profiles & Device Management
, tap on your certificate and then Trust
Done. (If using a free developer account, repeat from step 4 after it expires in 7 days)
Connect your device (you may need to launch iTunes and choose Trust…
when it pops up).
…Follow instructions via altstore.io and the app as it guides you.
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.
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:
2) Use a different Apple ID that is not an expired and deprecated Safari Developer account.
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).
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 get stuck, check out .
Download and launch .
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 ().
: Window → Devices and Simulators: Select your device. Drop the new .ipa
file onto Installed Apps.
: Double-click your device → Apps: Drop the new .ipa
file here.
Download and launch .
(If you haven't yet), login to your online and Generate
an App-Specific Password, under Security section (and write it down somewhere for later use).
: Window → Devices and Simulators: Select your device. Drop the new .ipa
file onto Installed Apps.
: Double-click your device → Apps: Drop the new .ipa
file here.
AltStore source is availble at Click in Mobile Safari once you have AltStore installed.
Download and launch .
If using 2-Factor Authentication, you will need to go to settings and make a key and save it for use in Cydia Impactor, type it verbatim.
1) Upgrade to a paid account.
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 , delete the app and try to clean-install.
🗯 If you are still stuck ask for on our Discord.