# Setup and usage
## Enable SSH ID
{% tabs %}
{% tab title="Desktop" %}
To create SSH ID on the desktop:
1. Navigate to `Termius > Settings > SSH ID`
2. Click the `Set up SSH ID` button to start the process
3. Choose your unique username. Wait for Termius to generate passkeys on this device
4. Open Termius on your other devices to generate passkeys there. It is recommended to use at least two devices
5. Your SSH ID is ready. Next, [Connect using SSH ID](#connect-using-ssh-id).
{% endtab %}
{% tab title="iOS" %}
To create SSH ID on iOS:
1. Open `Profile` then tap SSH ID
2. Tap `Set up your SSH ID` button to start the process
3. Choose your unique username. Wait for Termius to generate passkeys on this device
4. Open Termius on your other devices to generate passkeys there
5. Select whether to use biometric passkeys by default
6. Your SSH ID is ready. Next, [connect using SSH ID](#connect-using-ssh-id).
{% endtab %}
{% tab title="Android" %}
To create SSH ID on Android:
1. Open `Settings`, then tap `Account settings` > `SSH ID`
2. Tap `Set up your SSH ID` button to start the process
3. Choose your unique username. Wait for Termius to generate passkeys on this device
4. Open Termius on your other devices to generate passkeys there
5. Select whether to use biometric passkeys by default
6. Your SSH ID is ready. Next, [connect using SSH ID](#connect-using-ssh-id).
{% endtab %}
{% endtabs %}
## Connect using SSH ID
To connect using an SSH ID, you first need to provision it on your servers and assign it to your hosts.
### Provision SSH ID to your server
There are several ways to copy the public keys under your SSH ID to your servers.
{% tabs %}
{% tab title="Shell command" %}
To copy the public keys to your server via shell command:
1. Connect to your server using the currently set up authentication method
2. Run the following command in the terminal:\
`curl -fs https://sshid.io/ >> ~/.ssh/authorized_keys`
{% hint style="info" %}
If you want to use non-default passkey types, use `https://sshid.io//` e.g., `https://sshid.io/username/RSA`
{% endhint %}
{% endtab %}
{% tab title="\~/.ssh/authorized\_keys" %}
To copy the public keys to your server manually:
1. Go to `https://sshid.io/`
2. Select `~/.ssh/authorized_keys`
3. Select the passkey type if you want to use a non-default one
4. Copy all your public keys
5. Connect to your server using the already set authentication method
6. Paste the copied public keys to the `~/.ssh/authorized_keys` file
{% endtab %}
{% endtabs %}
### Link SSH ID with your hosts
Once the provisioning step is completed, you need to assign SSH ID to the required hosts to easily connect to them from your devices.
{% tabs %}
{% tab title="Desktop" %}
To link SSH ID with your hosts on the desktop:
1. Open Host details on the host you want to connect to with SSH ID
2. Navigate to the `Credential` section and click `+ SSH ID, Key, Certificate, FIDO2`
3. Choose `SSH ID` as the authentication method. Termius auto-saves the changes
{% endtab %}
{% tab title="iOS" %}
To link SSH ID with your hosts on iOS:
1. Tap the host icon you want to connect to with SSH ID and tap `Edit`
2. In the Credentials section, tap `SSH.id, Key, Certificate, FIDO2`
3. Choose `SSH ID` as the authentication method
4. `Save` the host changes
{% endtab %}
{% tab title="Android" %}
To link SSH ID with your hosts on iOS:
1. Tap the host icon you want to connect to with SSH ID and tap `Edit`
2. In the Credentials section, tap `SSH.id, Key, Certificate, FIDO2`
3. Choose `SSH ID` as the authentication method
4. `Save` the host changes
{% endtab %}
{% endtabs %}
---
# 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/ssh-id-passkeys-for-ssh/setup-and-usage.md?ask=
```
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.
.png?alt=media&token=d711f7b3-0d3c-4acc-98fe-3be3f6016ad6)
.png?alt=media&token=3d0c28ca-8fee-4b3a-8772-711169896b4c)
