Sideloading
Easy. Install pre-built releases (or pre-releases).
Prebuilt .ipa releases can be sideloaded onto your devices and must be re-signed using your own developer profile(s).
Download Provenance
First, download a Release or Prerelease of Provenance (unless using AltStore, direct source download link in AltStore instructions).
Choose a sideloading method:
Sideloading Options:
❇️ AltStore · macOS/Windows
🖋 iOS App Signer · macOS + Xcode or Configurator
🧪 AltDeploy · macOS
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-Ccable¹Apple TV 4:
USB-C→USB-A / USB-Ccable¹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.
AltStore source is available at this link — click in Mobile Safari once you have AltStore installed.
Download and launch AltStore.
Connect your device (you may need to open Finder and choose
Trust…when it pops up).Follow instructions via altstore.io and the app as it guides you.
Put the 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.
Free Apple developer provisioning expires every 7 days, but AltStore can keep track of and handle renewal for you. Re-sideloading will not cause you to lose any data.
Windows AltStore has not been tested by the Provenance team. Support may be limited.
Download and launch iOS App Signer.
Select
.ipafile and resign it to yourself, selecting the Provenance Bundle ID you've used in the past. If you don't have one, create one: 🆔 Bundle ID:com.[change-this].provenance— replace[change-this]with something unique like your username.Connect your device. ⚠️ If you haven't yet, register your device to your Apple ID in Xcode. Easiest way is to make a dummy app in Xcode and have it automatically create the provisioning (Example).
Install:
Xcode: Window → Devices and Simulators → Select your device → Drop the
.ipaonto Installed Apps.Configurator: Double-click your device → Apps → Drop the
.ipahere.
On device: Go to
Settings→General→Profiles & Device Management, tap on your certificate and thenTrust.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.
Download and launch AltDeploy.
Connect your device (you may need to open Finder and choose
Trust…when it pops up).Select your device in AltDeploy.
Drag & drop
.ipafile onto Impactor.Enter your Apple ID.
If not using 2-Factor Authentication, enter your account password, otherwise:
Login to your Apple ID online and
Generatean App-Specific Password under Security section.Enter your App-Specific Password in AltDeploy, verbatim.
Install:
Xcode: Window → Devices and Simulators → Select your device → Drop the
.ipaonto Installed Apps.Configurator: Double-click your device → Apps → Drop the
.ipahere.
On device: Go to
Settings→General→Profiles & Device Management, tap on your certificate and thenTrust.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 generate an App-Specific Password. Enter it verbatim in your sideloading tool.
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. Delete some apps you are signing, or install with a different Apple ID and Bundle IDs.
If you used to have a free Safari Developer Account (no longer supported by Apple):
Upgrade to a paid Apple Developer account, or
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. 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 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.
Last updated