# Troubleshooting Installation Issues

Having trouble installing the Onside Store app? This page lists common issues and how to resolve them.

{% hint style="warning" %}
If installation is blocked, first check your Apple Account **Country/Region**. It must be set to an **EU country/region** or **Japan**.
{% 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 %}

Check: **Settings > \[Your Name] > Media & Purchases > View Account > Country/Region**.

<details>

<summary><strong>I’m in the EU or Japan but I still can’t install the Onside Store.</strong></summary>

* **Update iOS/iPadOS:**

  * **iPhone**
    * **EU:** iOS **17.6 or later**
    * **Japan:** iOS **26.2 or later**
  * **iPad (EU only):** iPadOS **18 or later**

  Go to **Settings > General > Software Update**.
* **Confirm physical location:** You must be physically located within the **EU** (excluding the UK) or **Japan**. On iPad, this must be the **EU**. A VPN will not bypass this requirement.
* **Check your Apple Account region:** Your Apple Account must be set to an **EU country/region** or **Japan**.
* **Free up storage:** Your device might not have enough free space. The Onside Store app is about 100MB, but iOS/iPadOS needs extra space during installation. We recommend at least **2GB** free.
* **Check your internet connection:** Try switching between Wi-Fi and mobile data.
* **Restart your device:** Restarting can resolve temporary issues.

If the issue persists, contact support and include your device model, iOS/iPadOS version, and the approximate time you attempted the installation.

</details>

<details>

<summary><strong>The Install button on onside.io doesn’t work.</strong></summary>

* **Use Safari or Chrome:** iOS blocks alternative marketplace installation flows in some other browsers.
* **Clear Safari website data:** Clear cache and cookies in Safari.
* **Try Private Browsing:** Open [onside.io](https://onside.io) in a Private tab.
* **Disable content blockers:** If you use ad/content blockers, temporarily disable them for [onside.io](https://onside.io).

</details>

<details>

<summary><strong>I’m seeing an error when downloading or updating apps (after installation).</strong></summary>

* Most download/update errors come from internet connectivity issues, insufficient device storage, or the app’s iOS version requirements.
* If you previously installed the same app from another source, uninstall it, then download it again from the Onside Store.

</details>

<details>

<summary><strong>I see NSURLError when downloading an app.</strong></summary>

Turn off your VPN and try again. VPNs can cause network errors (including NSURLError) during downloads.

</details>

***

### FAQs

<details>

<summary><strong>Why can’t I install Onside on iOS 17.5 or earlier?</strong></summary>

In the EU, Apple’s framework for alternative app marketplaces is available on iOS **17.6** and later.

In Japan, alternative app marketplaces are available starting iOS **26.2** under the **MSCA**.

Onside Store requires the minimum iOS version that supports alternative app marketplaces in your region.

Staying on a recent iOS version also helps ensure you receive Apple’s latest security updates.

</details>

<details>

<summary><strong>How can I be sure the Onside website is official?</strong></summary>

The only official Onside website is [onside.io](https://onside.io).

Always check the domain name in your browser’s address bar. You can also check the website certificate by clicking the padlock icon; it should show “Onside” (or our registered company name) as the verified organization.

</details>

<details>

<summary><strong>Can I download apps from Onside without installing the Onside Store app?</strong></summary>

No. To install apps from Onside, you must first install the Onside Store marketplace app on your iPhone (or iPad in the EU).

</details>

<details>

<summary><strong>Can I download apps without creating an Onside account?</strong></summary>

Currently, you need an account to download apps.

</details>

<details>

<summary><strong>If I delete an old version of a game and download a new one from Onside, will I lose my progress?</strong></summary>

It depends on the game. Some games support progress sync or account-based save data.

Check the game’s app page for developer instructions.

</details>

<details>

<summary><strong>How do I uninstall the Onside Store?</strong></summary>

Uninstall the Onside Store app like any other iOS app:

1. Press and hold the Onside Store app icon on your Home Screen (or in the App Library).
2. Tap **Remove App**.
3. Tap **Delete App** to confirm.

</details>

<details>

<summary><strong>Where are apps from Onside installed on my iPhone?</strong></summary>

Apps you download from Onside install to your device’s internal storage, like apps from other sources. They appear on your Home Screen and in the App Library.

</details>

<details>

<summary><strong>How much free storage do I need to install the Onside Store?</strong></summary>

The Onside Store app is relatively small (around 100MB). However, iOS needs extra space to complete installations.

We recommend at least **2GB** of free storage.

</details>

<details>

<summary><strong>Is installing Onside safe?</strong></summary>

If you install the Onside Store from our official website, [onside.io](https://onside.io/), it is safe.

Apps listed in the Onside Store also undergo review and security checks before we make them available.

</details>

<details>

<summary><strong>Can I install Onside on iPad, Apple Watch, or a computer?</strong></summary>

The Onside Store currently supports:

* **iPhone:** iOS **17.6+** in the EU, iOS **26.2+** in Japan
* **iPad (EU only):** iPadOS **18+**

In **Japan**, Onside Store is **not supported on iPad**.

We do not currently support Apple Watch, or macOS.

</details>

***

{% 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/troubleshooting-installation-issues.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.