> For the complete documentation index, see [llms.txt](https://docs.onside.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onside.io/store/getting-started/how-to-install-onside-store.md).

# 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](/store/getting-started/how-to-install-onside-store/troubleshooting-installation-issues.md).

### 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="/files/SbljZHJEfNqSGTOqOcfl" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/Dc8Bkkc2J2VRc8C6Id6R" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/3hkECF1haBHvuIawp5us" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/XBji2T7cDUaUmcd81ds9" alt=""><figcaption></figcaption></figure></div>

6. Open **Onside Store** and start downloading apps. You can create an account later.

<div align="left"><figure><img src="/files/lLh61zTp7ONG6mFPpcxI" 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**.

![](/files/Y016tWhCfOIqIKhEYayi)

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

![](/files/fzvcKKaAc4134Ze6yXxD)

4. Tap **Open Onside Store**.

![](/files/eoTO1mKA19Xnclfqlril)

5. Start downloading apps. You can create an account later.

<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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.onside.io/store/getting-started/how-to-install-onside-store.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.