> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/authentication/1kosmos-mobile-application/installation.md).

# Installation

The 1Kosmos mobile app is available on iOS and Android. We recommend installing from your device's app store to ensure automatic updates and complete functionality.

***

#### Install from app stores

IOS

1. Open the **App Store** on your iPhone or iPad.
2. Search for **1Kosmos**.
3. Tap **Install**.
4. Once installed, open the app to begin setup.

{% hint style="info" %}
Touch ID and Face ID are fully supported on iOS devices.
{% endhint %}

Android

1. Open the **Google Play Store** on your device.
2. Search for **1Kosmos**.
3. Tap **Install**.
4. Once installed, open the app to begin setup.

{% hint style="warning" %}
Push notifications require Google Play Services. Devices without GPS will not receive push-based authentication requests. 
{% endhint %}

#### Install via APK (Android only)

Users with a supported version of Android can sideload the 1Kosmos app — useful for organizations with restricted access to Google Play.

{% hint style="info" %}
Sideloading requires 1Kosmos mobile app **v1.30.50 or newer**. Users who sideload are responsible for manually updating the app for future releases.
{% endhint %}

**Steps**

1. Download the latest APK file [here](https://storage.googleapis.com/1kosmos-static/docx/android-apk/1Kosmos.apk).
2. Open the **File Manager** app (or Google's **Files** app) on your device.
3. Locate the downloaded APK and tap to open it.
4. When prompted, enable the **Allow from this source** setting to permit installation of unknown apps.
5. Confirm installation and launch the app.

{% hint style="info" %}
Steps may vary slightly depending on your device manufacturer and Android version.
{% endhint %}

#### Permissions required

For the app to function correctly — especially on MDM-managed devices — administrators must ensure the following permissions are enabled:

| Permission        | Purpose                                            |
| ----------------- | -------------------------------------------------- |
| **Location**      | Contextual access policies and risk evaluation     |
| **Notifications** | Receive push-based authentication requests         |
| **Phone**         | SIM-based phone number verification                |
| **Camera**        | QR code scanning and ID document enrollment        |
| **Biometrics**    | Face ID / Touch ID for passwordless authentication |

#### Uninstalling the app

To uninstall the 1Kosmos app:

1. Open the **Apps drawer**.
2. Press and hold the **1Kosmos** icon.
3. Select **App info**, then tap **Uninstall**.
4. Confirm by tapping **OK**.

{% hint style="danger" %}
Uninstalling the app permanently deletes all locally stored accounts and wallet data. Make sure to back up your **12-word recovery mnemonic** before uninstalling, or you will lose access to your identity wallet.
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.1kosmos.com/authentication/1kosmos-mobile-application/installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.