> For the complete documentation index, see [llms.txt](https://wiki.provenance-emu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.provenance-emu.com/getting-started/installing-provenance.md).

# Installing Provenance

Provenance supports **38+ retro gaming systems** and runs on iPhone, iPad, Apple TV, and Mac. Choose the installation method that works best for you.

## 📱 Recommended: App Store (Easiest)

**The simplest way to install Provenance is directly from the App Store.**

✅ **Benefits:**

* ⚡ One-tap installation
* 🔄 Automatic updates
* ☁️ iCloud sync (with Provenance Plus)
* 🆓 **100% FREE** (with optional Provenance Plus subscription)
* ✨ No technical setup required

👉 [**Get Provenance from the App Store →**](/getting-started/installing-provenance/app-store.md)

***

## 🔧 Alternative Installation Methods

For advanced users who want more control or need specific features:

* [**Alternative Installation Guide**](/getting-started/installing-provenance/advanced.md) - Overview of sideloading and building options
  * [Sideloading](/getting-started/installing-provenance/advanced/sideloading.md) - Install pre-built .ipa files (free, requires re-signing every 7 days)
  * [Building from Source](/getting-started/installing-provenance/advanced/building-from-source.md) - Compile directly from GitHub (for developers)

⚠️ **Note:** Alternative methods require a (free) Apple Developer account and periodic re-signing. Most users should use the App Store version.

***

## 🔄 Updating Provenance

* **App Store users:** Updates are automatic through the App Store
* **Sideloaders/builders:** See [Updating Guide](/getting-started/installing-provenance/updating.md)

***

## ❓ Frequently Asked Questions

**Is Provenance really free?**\
Yes! Provenance is 100% free to download and use. Provenance Plus is an optional subscription that adds premium features like iCloud sync and beta access.

**What's Provenance Plus?**\
An optional subscription ($3.99/month, $39.99/year, or $99.99 lifetime) that unlocks:

* ☁️ iCloud library and save sync across devices
* 🔔 Early access to new cores and features
* 🎮 Priority support

See the [App Store installation guide](/getting-started/installing-provenance/app-store.md) for full details.

**Do I need to sideload?**\
No! The App Store version is recommended for 90%+ of users. Sideloading is only necessary if you want bleeding-edge development builds.

**Can I migrate from sideload to App Store?**\
Yes! Your saves and ROMs will transfer. See the [App Store guide](/getting-started/installing-provenance/app-store.md) for migration instructions.

***

## 📚 Next Steps

After installation:

1. 📖 [BIOS Requirements](/getting-started/bios-requirements.md) - Required system files for certain emulators
2. 🎮 [Importing ROMs](/using-provenance/importing-roms.md) - Add your game library
3. 🎮 [Controllers & Controls](/using-provenance/controllers-and-controls.md) - Connect your favorite controller
4. ⚙️ [Troubleshooting](/help-and-community/troubleshooting.md) - Common issues and solutions