# How to Install Onside Store

### Before you start

{% hint style="warning" %}
Your Apple Account **Country/Region** must be set to an **EU country/region** or **Japan**. Otherwise iOS blocks alternative marketplace installation.
{% endhint %}

{% hint style="warning" %}
On **iPad**, Onside Store is available **in the EU only** (iPadOS **18+**). It is **not available on iPad in Japan**.
{% endhint %}

Make sure you:

* **Use Safari or Google Chrome.** iOS blocks alternative marketplace installation flows in some other browsers.
* **Are physically located in the EU (excluding the UK) or Japan.** On iPad, this must be the **EU**. A VPN will not bypass this requirement.
* **Use an Apple Account with an EU country/region or Japan.**
  * Check: **Settings > \[Your Name] > Media & Purchases > View Account > Country/Region**.

<details>

<summary><strong>How to check or change your App Store country/region</strong></summary>

Go to **Settings > \[Your Name] > Media & Purchases > View Account**. You might need to sign in.

Tap **Country/Region > Change Country or Region**, select your country/region (EU country or Japan), and follow the on-screen instructions.

Changing your region may affect existing subscriptions and payment methods tied to your Apple ID.

</details>

* **Run a supported iOS/iPadOS version.**
  * **iPhone**
    * **EU:** iOS **17.6 or later**
    * **Japan:** iOS **26.2 or later** (MSCA support)
  * **iPad (EU only):** iPadOS **18 or later**

<details>

<summary><strong>How to check and update your iOS/iPadOS version</strong></summary>

Go to **Settings > General > Software Update**. If an update is available, install it.

</details>

{% hint style="info" %}
In Japan, iOS alternative app marketplaces are enabled under the **MSCA**. Apple may show additional authorization prompts during installation. Apps distributed outside the App Store also go through Apple’s baseline **Notarization** checks.
{% endhint %}

If you run into issues, see [Troubleshooting Installation Issues](https://docs.onside.io/store/getting-started/how-to-install-onside-store/troubleshooting-installation-issues).

### Installation steps

<a href="https://onside.io" class="button primary">Install Onside</a>

After you confirm the prerequisites, follow the steps for your iOS/iPadOS version.

{% columns %}
{% column width="50%" %}

### iOS 18.6- installation flow

1. Open [onside.io](https://onside.io/) in Safari and tap **Install Onside**.
2. Tap **OK** to dismiss the iOS notice about installing an alternative app marketplace.

<div align="left" data-full-width="false"><figure><img src="https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2FQG6RKlNIDqokKM6yBcTS%2FGroup%201948756901.svg?alt=media&#x26;token=1b56c8a2-f110-427e-aa82-3078ad4238f9" alt=""><figcaption></figcaption></figure></div>

3. Open **Settings** and allow marketplace installation for Onside.

<div align="left"><figure><img src="https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2FJsDYk9UIrNzsZ37aqvZo%2F%F0%9F%93%B1%20Settings%20%E2%80%BA%20Home.svg?alt=media&#x26;token=dd2b4e80-3641-455e-8b9c-b28fbec24199" alt=""><figcaption></figcaption></figure></div>

4. Return to Safari and tap **Install Onside** again.

<div align="left"><figure><img src="https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2F33Ulrk2sHHkac2o8i1iL%2FInstalling%20web%20page.svg?alt=media&#x26;token=707863d4-4953-4e22-b1dd-301d750c511c" alt=""><figcaption></figcaption></figure></div>

5. Tap **Install App Marketplace** to finish.

<div align="left"><figure><img src="https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2FSk8v163x1bhTAoUoFKQG%2FGroup%201948756902.svg?alt=media&#x26;token=6f3abac1-fb3a-436d-8e43-cc391829948a" alt=""><figcaption></figcaption></figure></div>

6. Open **Onside Store**, create your account, and start downloading apps.

<div align="left"><figure><img src="https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2FVmUJTR40GVqNL1azVv8i%2FComp_11%201.svg?alt=media&#x26;token=4357194b-a01e-4bc0-a8fb-8172173008ac" alt=""><figcaption></figcaption></figure></div>

<a href="https://onside.io" class="button primary">Install Onside</a>
{% endcolumn %}

{% column %}

### iOS 18.6+ installation flow

1. Open [onside.io](https://onside.io/) in Safari and tap **Install Onside**.
2. Tap **Allow Installation**.

![](https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2FIFKGuySeuEWoqp46XysV%2Fimages.png?alt=media\&token=3fa02c82-6436-4c52-946d-6fc1441aa725)

3. Confirm installation via **Face ID** or your Apple ID password.

![](https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2FioqD7zrIXhSK5b6ev6lo%2Fimage%2080.png?alt=media\&token=4ffd3f49-8524-4fee-9026-7e5ff05ba238)

4. Tap **Open Onside Store**.

![](https://1223683575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6W2Xq8YQWUKNGf4QCyg%2Fuploads%2F6pINRtwALqOOVjQlHv7t%2Fimage%2081.png?alt=media\&token=09c789f6-01ac-4ce5-b4f5-70e4e7a34b7a)

5. Create your account and start downloading apps.

<a href="https://onside.io" class="button primary">Install Onside</a>
{% endcolumn %}
{% endcolumns %}

***

{% hint style="info" %}
If you still need help, contact Onside support via the chat in the bottom-right corner, or email <support@onside.io>.
{% endhint %}


---

# 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://docs.onside.io/store/getting-started/how-to-install-onside-store.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.