Updating Provenance

How to update your Provenance installation

How you update depends on how you installed Provenance:

App Store (Automatic)

App Store updates are automatic — no action needed.

To verify you're on the latest version:

1. Open the App Store

2. Tap your profile icon (top right)

3. Scroll to Provenance — tap Update if available

Tip: Make sure Automatic Downloads is enabled in Settings → App Store so updates install in the background.

Sideloaded (.ipa)

To update a sideloaded installation:

1. Download the latest .ipa from GitHub Releases

2. Re-sign and install using your sideloading tool (AltStore, Sideloadly, iOS App Signer)

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

Built from Source (Terminal)

If you built from source, pull the latest changes and rebuild:

1. Navigate to your Provenance directory:

   cd /path/to/Provenance

2. Pull the latest source:

   Option A — Overwrite local changes (easiest, reapply Bundle ID after):

   git pull origin develop

   Option B — Preserve local changes (keeps your Bundle ID and code modifications):

   git stash
   git reset --hard HEAD
   git pull origin develop
   git stash pop

3. Update submodules and open in Xcode:

   make update
   make open

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

5. Provenance compiles and installs on your device

Built from Source (Tower)

If you use Tower as your Git client:

1. Open Provenance in Tower (Repositories → double-click Provenance)

2. With the develop branch selected (HEAD), click Fetch

3. If the branch shows pending changes, click Pull

4. Click Stash Changes if you have local modifications

5. After pulling, click Apply Stash to restore your changes

6. In Terminal:

   cd /path/to/Provenance
   make update
   make open

7. In Xcode, press Run to build and install

---

Command-Line Build Shortcuts

If you've already completed the first-time setup, you can update and build entirely from Terminal:

# iPhone / iPad
make ios

# Apple TV
make tvos

These commands pull the latest source, update submodules, and build in one step.

---

Need help? Ask on Discord.