> 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

***

#### 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.20.81 or newer**. Users who sideload are responsible for manually updating the app for future releases.
{% endhint %}

Steps

1. Download the latest APK file from your 1Kosmos administrator or the official distribution link.
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. Enable the **Allow from this source** setting when prompted 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 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.1kosmos.com/authentication/1kosmos-mobile-application/installation.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.