# Identities

## Overview

An **identity** in Termius stores a username, password, and key together. Link an identity to multiple Hosts or Groups to reuse the same credentials without duplication.

Identities are stored in vaults. Vaults protect your data with end-to-end encryption. For details, see [Encryption overview](/security/encryption-overview.md).

{% hint style="info" %}
Autocomplete can paste passwords from identities. When a password prompt appears in the terminal, Termius suggests the stored password.
{% endhint %}

## Create an identity

{% tabs %}
{% tab title="Desktop" %}
To create an identity on the desktop:

1. Navigate to the `Keychain` and select `New Identity` from the key drop-down<br>

   <figure><img src="/files/jAQzowVrzSu9MtyGicCn" alt=""><figcaption></figcaption></figure>
2. Enter a name in the `Label` field
3. Enter the username in the `Username` field
4. Enter a password or select a `Key, Certificate, FIDO2 key`. Termius auto-saves the identity

   <figure><img src="/files/WMgSK5Nd0Dp9YOxwPvBE" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="iOS" %}
To create an identity on iOS/Android:

1. Tap the back arrow button `<` to open the **Vaults** screen, then open the `Keychain` screen<br>

   <div align="left"><figure><img src="/files/TZ1pRGG18ka51wufGMeA" alt="" width="375"><figcaption></figcaption></figure></div>
2. Tap the `+` button and select `New identity` in the context menu<br>

   <div align="left"><figure><img src="/files/r3BZHry1vS7mnAp72sIg" alt="" width="375"><figcaption></figcaption></figure></div>
3. Enter a name in the `Label` field
4. Enter the username in the `Username` field
5. Enter a password or select a `Key`<br>

   <div align="left"><figure><img src="/files/AWTiFFuzHNR9KUBpsxTf" alt="" width="375"><figcaption></figcaption></figure></div>
6. `Save` the identity
   {% endtab %}

{% tab title="Android" %}
To create an identity on Android:

1. Tap `< All vaults` to open the **Vaults** screen, then open the `Keychain` screen<br>

   <div align="left"><figure><img src="/files/QtqCO3uroxSZ0Gjb6UB8" alt="" width="375"><figcaption></figcaption></figure></div>
2. Tap the `+` button and select `New identity` in the context menu<br>

   <div align="left"><figure><img src="/files/CoDtSErufUITLvhzb79L" alt="" width="375"><figcaption></figcaption></figure></div>
3. Enter a name in the `Label` field
4. Enter the username in the `Username` field
5. Enter a password or select a `Key`<br>

   <div align="left"><figure><img src="/files/jOitpjVH2i9TxVnEA1Ci" alt="" width="375"><figcaption></figcaption></figure></div>
6. `Save` the identity
   {% endtab %}
   {% endtabs %}

## Link an identity to a host

{% tabs %}
{% tab title="Desktop" %}
To link an identity to a host on the desktop:

1. Open the `Hosts` screen, right-click the host, and select `Edit Host Details`<br>

   <figure><img src="/files/llXmxvKlXULOSK7Rnc9x" alt=""><figcaption></figcaption></figure>
2. In the Credentials section, click the `Username` field and select an identity<br>

   <figure><img src="/files/JNb93ODDANcJmBoL9pt9" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="iOS" %}
To link an identity to a host or group on iOS/Android:

1. Open the `Hosts` screen. Tap the host icon, then tap the edit icon.<br>

   <div align="left"><figure><img src="/files/ZuFexkFsovOx504vPg7F" alt="" width="375"><figcaption></figcaption></figure></div>
2. Tap the user icon on the right side of the `Username` field, then select an identity<br>

   <div align="left"><figure><img src="/files/9DPaPilWZo5WNa2oajDN" alt="" width="375"><figcaption></figcaption></figure></div>

{% endtab %}

{% tab title="Android" %}
To link an identity to a host or group on Android:

1. Open the `Hosts` screen. Tap the host icon, then tap the edit icon.<br>

   <div align="left"><figure><img src="/files/Yv0xp2ou1ztQJts8dnkM" alt="" width="375"><figcaption></figcaption></figure></div>
2. Tap the user icon on the right side of the `Username` field, then select an identity<br>

   <div align="left"><figure><img src="/files/toipMoXkBE09phYuSXln" alt="" width="375"><figcaption></figcaption></figure></div>

{% endtab %}
{% endtabs %}

{% hint style="info" %}
When working with multiple vaults, if you don't see your identity in the list, make sure the identity and the host are in the same vault.\
\
To choose the vault where your identities are stored, click `Credentials from` in the Credentials section, and select the vault.
{% endhint %}

## Use identities in Autocomplete

When Termius detects a password prompt in the terminal, it can suggest identities with stored passwords. This is useful for `sudo` prompts.

<figure><img src="/files/GQ2kp5FOotDeB0lDimto" alt=""><figcaption></figcaption></figure>


---

# 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.termius.com/keychain/identities.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.
