# 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 →**](https://wiki.provenance-emu.com/getting-started/installing-provenance/app-store)

***

## 🔧 Alternative Installation Methods

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

* [**Alternative Installation Guide**](https://wiki.provenance-emu.com/getting-started/installing-provenance/advanced) - Overview of sideloading and building options
  * [Sideloading](https://wiki.provenance-emu.com/getting-started/installing-provenance/advanced/sideloading) - Install pre-built .ipa files (free, requires re-signing every 7 days)
  * [Building from Source](https://wiki.provenance-emu.com/getting-started/installing-provenance/advanced/building-from-source) - 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](https://wiki.provenance-emu.com/getting-started/installing-provenance/updating)

***

## ❓ 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](https://wiki.provenance-emu.com/getting-started/installing-provenance/app-store) 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](https://wiki.provenance-emu.com/getting-started/installing-provenance/app-store) for migration instructions.

***

## 📚 Next Steps

After installation:

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.provenance-emu.com/getting-started/installing-provenance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.