Provenance EMU
  • Welcome
  • Frequently Asked Questions
  • Installation & Usage
    • Installing Provenance
      • Sideloading
      • Building from Source
      • Updating
    • BIOS Requirements
    • ROMs
      • Importing ROMs
      • Formatting ROMs
      • Customizing ROMs
      • Modding ROMs
  • Info
    • Supported Systems
    • Controllers & Controls
      • Controllers
        • Controller Reviews
      • Controls
    • Game Saves
    • Miscellaneous
      • Restoring Files
      • Launch ROMs via URL
      • Virtualizing macOS
  • Help
    • Troubleshooting
    • Contributing
    • Discord
  • Development
    • GitHub
    • Release Roadmap
Powered by GitBook
On this page
  • Download Provenance
  • Sideloading Options:
  • iOS App Signer
  • AltDeploy
  • AltStore
  • 💢 Troubleshooting
  • Cannot authenticate
  • Unable to code-sign / install…
  • —application-identifier entitlement does not match…
  • Your maximum App ID limit has been reached…
  • Duplicate app

Was this helpful?

  1. Installation & Usage
  2. Installing Provenance

Sideloading

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

PreviousInstalling ProvenanceNextBuilding from Source

Last updated 2 years ago

Was this helpful?

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 or Prerelease of Provenance (unless using AltStore, direct source download link in AltStore insructions).

  2. Choose a sideloading method:

Sideloading Options:

  • ❇️ · 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.

iOS App Signer

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

  2. Install:

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

  4. 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. Connect your device (you may need to launch iTunes and choose Trust… when it pops up).

  2. Select your device in Impactor.

  3. Drag & drop .ipa file onto Impactor.

  4. Enter your Apple ID.

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

    1. Enter your App-Specific Password in AltDeploy, verbatim.

  6. Install:

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

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

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

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

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

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:

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

—application-identifier entitlement does not match…

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

iOS App Signer
Example
Xcode
Configurator
AltDeploy
Apple ID
Xcode
Configurator
this link
AltStore
Apple ID
Apple Developer
backup your files
help
Troubleshooting
Release
Apple Developer
Instructions
ports
AltStore
iOS App Signer
AltDeploy
configure your network settings