Updating Provenance
How to update your Provenance installation
Last updated
How to update your Provenance installation
How you update depends on how you installed Provenance:
App Store updates are automatic — no action needed.
To verify you're on the latest version:
Open the App Store
Tap your profile icon (top right)
Scroll to Provenance — tap Update if available
Tip: Make sure Automatic Downloads is enabled in Settings → App Store so updates install in the background.
To update a sideloaded installation:
Download the latest .ipa from GitHub Releases
Re-sign and install using your sideloading tool (AltStore, Sideloadly, iOS App Signer)
Install over your existing version — use the same Bundle ID to preserve data
Installing over an existing sideloaded version preserves your ROMs, saves, and settings. Using a different Bundle ID creates a separate installation.
Full guide: Sideloading
If you built from source, pull the latest changes and rebuild:
Navigate to your Provenance directory:
cd /path/to/ProvenancePull the latest source:
Option A — Overwrite local changes (easiest, reapply Bundle ID after):
git pull origin developOption B — Preserve local changes (keeps your Bundle ID and code modifications):
git stash
git reset --hard HEAD
git pull origin develop
git stash popUpdate submodules and open in Xcode:
make update
make openIn Xcode:
If you used Option A, reapply your Bundle ID and signing settings
If you used Option B, just press Run (your settings are preserved)
Provenance compiles and installs on your device
If you use Tower as your Git client:
Open Provenance in Tower (Repositories → double-click Provenance)
With the develop branch selected (HEAD), click Fetch
If the branch shows pending changes, click Pull
Click Stash Changes if you have local modifications
After pulling, click Apply Stash to restore your changes
In Terminal:
In Xcode, press Run to build and install
If you've already completed the first-time setup, you can update and build entirely from Terminal:
# iPhone / iPad
make ios
# Apple TV
make tvosThese commands pull the latest source, update submodules, and build in one step.
Need help? Ask on Discord.
Last updated
cd /path/to/Provenance
make update
make open