> 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/faqs.md).
# FAQs
### Getting started
What is the 1Kosmos app?
1Kosmos is a consumer identity management app that replaces passwords with biometrics, QR codes, and verifiable credentials. It also acts as a digital wallet for storing identity documents and credentials issued by trusted authorities.
How many accounts can I link to one device?
You can link multiple accounts to a single device. The home screen shows all linked accounts and lets you switch between them. Each account has its own OTP and authentication state.
### Authentication
What if I'm offline — can I still authenticate?
Yes. The Workstation OTP (visible on the app home screen) works offline. Push notifications require an internet connection, but OTP is always available as a fallback.
What happens after 10 wrong PIN attempts?
On both Android and iOS, 10 consecutive incorrect PIN attempts will automatically reset the app. All accounts and wallet data on the device will be permanently deleted.
* **Android** — PIN or biometric failures count toward the limit.
* **iOS** — Only PIN failures count (biometric checks are validated by the OS).
Make sure to back up your recovery mnemonic before this happens.
What is LiveID and when is it required?
LiveID is a real-time selfie captured by the front camera to confirm liveness — that a real person is present, not a photo or recording. It is required:
* Before enrolling your Social Security Number
* During high-assurance identity verification flows
* For wallet restoration if previously enrolled
Why do I have to authenticate every time I open the app?
Authentication on every app launch protects your accounts and wallet from unauthorized access. You can authenticate using your PIN or biometrics — biometrics are typically faster and recommended.
### Identity & wallet
What documents can I enroll?
You can enroll:
* Driver's License (front + back + selfie)
* Passport (with optional RFID verification)
* Social Security Number
{% hint style="warning" %}
SSN enrollment requires a LiveID and at least one of Driver's License or Passport to be enrolled first.
{% endhint %}
What is a recovery mnemonic and why do I need it?
It's a 12-word phrase that acts as the master key to your identity wallet. If you lose your device or reinstall the app, this phrase is the only way to recover your wallet and enrolled identity documents. Save it somewhere safe immediately after setup.
See Backup & recovery for guidance.
What are verifiable credentials?
Verifiable credentials are digital credentials that can be added, presented, and deleted from your 1Kosmos wallet. They are stored on your device and can be shared with relying parties as part of identity verification flows.
What is Identity Assurance Level (IAL)?
IAL is a baseline score reflecting how thoroughly your identity has been verified. It's based on the biometric assets and identity documents you've enrolled. Higher IAL is unlocked as you enroll more assets.
You can check your IAL in the app menu, beneath your User Profile.
### Troubleshooting
I'm not receiving push notifications. What should I do?
Check the following:
1. Notification permissions are enabled for the 1Kosmos app in device settings
2. Your device has Google Play Services (Android only)
3. You have an active internet connection
If sideloading the APK on a non-GMS Android device, push notifications are not available — use Workstation OTP instead.
My account shows as orphaned. What does that mean?
An orphaned account appears when an administrator has unlinked your device in the AdminX portal. From app version v1.10.90 onwards, orphaned accounts are automatically removed when the app launches, and you'll be notified.
Contact your administrator to re-onboard.
How do I report an issue or get support?
Tap the help icon at the bottom right of the home screen, or go to **Menu → Need help?**. Describe your issue, attach up to 3 screenshots, and submit. A support ticket will be created automatically for the 1Kosmos team.
The app is asking me to update — what does that mean?
Starting with v1.20.60, the app has a force upgrade mechanism for security and feature consistency. When triggered:
* Tap **Update Now** to redirect to your app store
* Tap **Later** to defer for 24 hours
Updating is recommended to ensure you have the latest security patches and features.
I lost my device. Can I recover my identity?
Yes — if you saved your 12-word recovery mnemonic.
1. Install the 1Kosmos app on a new device
2. Tap **Restore** on the Welcome screen
3. Choose **Recover Identity Wallet**
4. Enter your 12-word phrase
If you don't have the mnemonic, contact your administrator. They may be able to re-onboard your account, but previously stored credentials and biometric assets cannot be recovered.
Can I uninstall and reinstall the app safely?
Only if you have your 12-word recovery mnemonic saved. Uninstalling permanently deletes all locally stored accounts and wallet data. The mnemonic is the only way to restore them.
---
# 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/faqs.md?ask=&goal=
```
`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.