# Connecting to a server

Termius provides users with a variety of options to connect to servers. It includes a built-in Local terminal and supports SSH, Mosh, Telnet, Serial, and SFTP.

## SSH with a password

{% tabs %}
{% tab title="Desktop" %}
To connect using a password on the desktop:

1. Open the `Vault` tab, then `Hosts` screen
2. Click `New Host`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FbE4y2u22CpzXtAXQtqLq%2FNew%20host.png?alt=media&#x26;token=ee5182f9-46ac-4f7a-953a-b09de5e0e3b7" alt=""><figcaption></figcaption></figure>
3. Enter the IP address, port, username, and password. Termius auto-saves your host<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F28tklMWSpR9PSbps7o88%2FNew%20host-1.png?alt=media&#x26;token=d2e27cff-524f-4b08-98e6-4b7d8621685f" alt=""><figcaption></figcaption></figure>
4. Click `Connect`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2Fb9Q01ovu6BmLygPPZZC1%2FNew%20host-2.png?alt=media&#x26;token=32ebea3e-fc23-4dc3-a8ff-55688d7b2f4f" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Mobile" %}
To connect using a password on mobile:

1. Tap the `+` button on the Hosts screen, then tap `New Host`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FvQYOtJSuQE8D0jMkKhQr%2FiOS01.png?alt=media&#x26;token=bef45755-5dd3-4a89-b8e9-2311d05e3ef1" alt="" width="375"><figcaption></figcaption></figure></div>
2. Enter the IP address, port, username, and password<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F0eA21rRDDH4FztReGEae%2FiOS02.png?alt=media&#x26;token=4fa3f786-8ae4-42b7-9576-97727b79b50f" alt="" width="375"><figcaption></figcaption></figure></div>
3. Tap `Save`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FETAzjKcybiWMyIVqHNmL%2FiOS03.png?alt=media&#x26;token=7fd5c427-d359-46b5-9d69-473f352b09da" alt="" width="375"><figcaption></figcaption></figure></div>
4. Tap your host to `Connect`
   {% endtab %}
   {% endtabs %}

## SSH with an SSH key

{% tabs %}
{% tab title="Desktop" %}
To connect to a server using an SSH key on the desktop:

1. Open the `Vault` tab, then `Hosts` screen
2. Click `New Host`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FbE4y2u22CpzXtAXQtqLq%2FNew%20host.png?alt=media&#x26;token=ee5182f9-46ac-4f7a-953a-b09de5e0e3b7" alt=""><figcaption></figcaption></figure>
3. Enter the IP address, port, and username<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F28tklMWSpR9PSbps7o88%2FNew%20host-1.png?alt=media&#x26;token=d2e27cff-524f-4b08-98e6-4b7d8621685f" alt=""><figcaption></figcaption></figure>
4. To add an SSH Key, click `+ SSH ID, Key, Certificate, FIDO2` section and choose `Key`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FcfxaG5kuHduRkwjgHa9S%2FNew%20host%20ssh%20key.png?alt=media&#x26;token=1783d4d9-6fa8-40d9-ae66-1e2da433fff8" alt=""><figcaption></figcaption></figure>
5. Enter the key name/label<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FKR9lOQ76bpPPikNvvxVm%2FNew%20host%20ssh%20key-1.png?alt=media&#x26;token=9b103579-685b-442f-95fb-e69ead6b0ef1" alt=""><figcaption></figcaption></figure>
6. Import or paste your private key, then click `Save` . Termius auto-saves your host<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FMxL6LLf8qNWIpH8RhpyS%2FNew%20host%20ssh%20key-2.png?alt=media&#x26;token=0a70c762-addd-46da-93aa-e9f863a82232" alt=""><figcaption></figcaption></figure>
7. Click `Connect`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F4yVlGXSx2T4WfqruaAR4%2FNew%20host%20ssh%20key-3.png?alt=media&#x26;token=16776e91-c0d1-41ca-b834-68bbafee1a15" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Mobile" %}
To connect to a server using an SSH key on mobile:

1. Tap the `+` button on the hosts screen and then tap `New Host`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FvQYOtJSuQE8D0jMkKhQr%2FiOS01.png?alt=media&#x26;token=bef45755-5dd3-4a89-b8e9-2311d05e3ef1" alt="" width="375"><figcaption></figcaption></figure></div>
2. Enter the IP address, port, and username<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F0eA21rRDDH4FztReGEae%2FiOS02.png?alt=media&#x26;token=4fa3f786-8ae4-42b7-9576-97727b79b50f" alt="" width="375"><figcaption></figcaption></figure></div>
3. To add an SSH Key, and tap `SSH ID, Key, Certificate, FIDO2` in credential section

<div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FDcXXInl5GLJN6pryFvgS%2FiOS_key_01.png?alt=media&#x26;token=b0022570-b685-498d-ab7a-b0f07d21ac6e" alt="" width="375"><figcaption></figcaption></figure></div>

4. Choose a key<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FkVunVDn5QgQ2JTbmNAOn%2FiOS_key_02.png?alt=media&#x26;token=00c5d045-394f-4e7a-86b0-0cd5dfd754d9" alt="" width="375"><figcaption></figcaption></figure></div>
5. Tap `Save`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FETAzjKcybiWMyIVqHNmL%2FiOS03.png?alt=media&#x26;token=7fd5c427-d359-46b5-9d69-473f352b09da" alt="" width="375"><figcaption></figcaption></figure></div>
6. Tap your host to `Connect`
   {% endtab %}
   {% endtabs %}

{% hint style="info" %}
See [Keychain](https://docs.termius.com/keychain) to explore all Termius Keychain capabilities.
{% endhint %}

## Connect through jump hosts

Jump hosts provide secure access to a target machine that is not directly reachable. Termius makes it easy to configure multiple jump hosts in a sequence called a **host chain**. This lets you connect to the target machine in one click, automatically hopping through the chain of your hosts. To set up a host chain, follow the steps below.

{% tabs %}
{% tab title="Desktop" %}

1. [Create a host](#ssh-with-a-password) or edit an existing one. This host is a target host
2. In the Host details screen, scroll down and click `Show more`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FW65GHPLlCY6SFSY3nKkx%2FJump%20host01.png?alt=media&#x26;token=5c5ac65b-cef4-4526-acda-ab8072941988" alt=""><figcaption></figcaption></figure>
3. Click `Host Chaining` field<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FRd5WHrcO0VUMW336cXLH%2FJump%20host02.png?alt=media&#x26;token=6b7d93b0-3a3e-46be-85c4-97010a00a1dd" alt=""><figcaption></figcaption></figure>
4. Select an `intermediate host` from the list or create a new one. You can select multiple intermediate hosts, reflecting your network configuration and use case.<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FZqkgwa6ql8rNrl4gbHZy%2FJump%20host04.png?alt=media&#x26;token=18c3f7d8-2ea2-4ff5-b0a1-f0680e6f3660" alt=""><figcaption></figcaption></figure>
5. Click `Save`. Then Termius auto-saves your host configuration<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FPQGALF2D3LM604xTfCzD%2FJump%20host05.png?alt=media&#x26;token=f730375d-dbd2-4c42-9c29-fbe556412d9f" alt=""><figcaption></figcaption></figure>
6. Click `Connect`. Termius sets up SSH tunnels to the target host through all the chained hosts<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FEjnIFs6OFRd8SAx5jspL%2FJump%20host03.png?alt=media&#x26;token=00265a30-9ebc-4502-b3c3-d64292869381" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Mobile" %}

1. Create a host or edit an existing one. This host is a target host<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FvQYOtJSuQE8D0jMkKhQr%2FiOS01.png?alt=media&#x26;token=bef45755-5dd3-4a89-b8e9-2311d05e3ef1" alt="" width="375"><figcaption></figcaption></figure></div>
2. In the `Edit Host` screen, scroll down and tap `Host Chaining`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F2kOkiFKDucviEF3zsl8k%2FJump%20Host_iOS-1.png?alt=media&#x26;token=79932859-17ca-41f7-a247-4cffebaf070b" alt="" width="375"><figcaption></figcaption></figure></div>
3. Select a `bastion host` from the list (if you already created one) or create a new one. You can select multiple intermediate hosts, reflecting your network configuration and use case.<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FjRBRHYf9V26mb9FagY30%2FJump%20Host_iOS-2.png?alt=media&#x26;token=24145677-8d8e-403c-9875-a067d8063067" alt="" width="375"><figcaption></figcaption></figure></div>
4. Tap `Save`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FAXoTZfPcYz8NJNaycNcl%2FJump%20Host_iOS-4.png?alt=media&#x26;token=07c58c49-dc77-46f0-b529-8fc169bbedf3" alt="" width="375"><figcaption></figcaption></figure></div>
5. Tap your `Target host` to connect. Termius sets up SSH tunnels to a `Target host` through all the chain hosts.
   {% endtab %}
   {% endtabs %}

{% hint style="info" %}
**Pro tip:** If you need the same host chain for multiple hosts, configure it on a group instead of setting it on each host.

Every host placed in this group inherits the host chaining settings from that group.
{% endhint %}

## Connect through a proxy

Termius supports SSH connections through HTTP or SOCKS5 proxies.

{% tabs %}
{% tab title="Desktop" %}
To connect through a proxy on the desktop:

1. Open the `Vault` tab, then `Hosts` screen
2. Click `New Host` or edit an existing one
3. In the Host details screen, scroll down, and click `Show more` if you don't see the extra options<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FW65GHPLlCY6SFSY3nKkx%2FJump%20host01.png?alt=media&#x26;token=5c5ac65b-cef4-4526-acda-ab8072941988" alt=""><figcaption></figcaption></figure>
4. Click the `Proxy` field<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2Fnxdmhjy4R8K3ndDuLDYH%2FProxy01.png?alt=media&#x26;token=9ba48193-e7f2-448c-b7f1-e87892f7f4bb" alt=""><figcaption></figcaption></figure>
5. In the `Type` drop-down, select the proxy server protocol: SOCKS5 or HTTP<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2Fp7g9ji35CQNiqt6oCrUR%2FProxy02.png?alt=media&#x26;token=e9815265-66c5-4f94-b7b2-137e974f4842" alt=""><figcaption></figcaption></figure>
6. Enter the hostname or address, port, and credentials of your proxy server<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F3hXD6wIeSdJqltN3EwlL%2FProxy03.png?alt=media&#x26;token=2e357396-7c1e-4839-b83d-ff3310500c3a" alt=""><figcaption></figcaption></figure>
7. Click `Save`. Then Termius auto-saves your host configuration<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2Flq3OiZhk0F8Tl0Munr2h%2FProxy04.png?alt=media&#x26;token=f2e24f1d-42dc-4376-9357-33e973454197" alt=""><figcaption></figcaption></figure>
8. Click `Connect`
   {% endtab %}

{% tab title="Mobile" %}
To connect through a proxy on mobile:

1. Create a host or edit an existing one<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FvQYOtJSuQE8D0jMkKhQr%2FiOS01.png?alt=media&#x26;token=bef45755-5dd3-4a89-b8e9-2311d05e3ef1" alt="" width="375"><figcaption></figcaption></figure></div>
2. In the `Edit host` screen, scroll down, and tap `Proxy`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FwSKcnH6vDw6F1rpY8ALf%2FiOS_proxy_01.png?alt=media&#x26;token=3a2e9c78-1c35-4e6b-bfba-1aba74e4e0ba" alt="" width="375"><figcaption></figcaption></figure></div>
3. Choose the type of proxy server protocol: SOCKS5 or HTTP<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FzKjl8fn2jIJPWtZkqH3k%2FiOS_proxy_02.png?alt=media&#x26;token=78c6417c-921d-4321-9619-9ace73c6fb38" alt="" width="375"><figcaption></figcaption></figure></div>
4. Enter the hostname or address, port, and credentials of your proxy server<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FL6jAEgVSsAjmiSHQR6AH%2FiOS_proxy_03.png?alt=media&#x26;token=ec37ae70-7356-4df8-bd59-edd0827023de" alt="" width="375"><figcaption></figcaption></figure></div>
5. Tap `Save`
6. Then `Save` the host to apply the changes
7. Tap your host to `Connect`
   {% endtab %}
   {% endtabs %}

## Mosh (Mobile Shell)

[Mosh](https://mosh.org/) is a companion protocol to SSH that maintains sessions when TCP connections are interrupted. It employs a parallel UDP session to keep the session alive. That also enables Mosh to maintain its own terminal buffer that intelligently echoes your input, even if the server is slow or the network lags.

The enhancements provided by Mosh are really important for reliable mobile connectivity. If your device changes networks or loses connection, Mosh can keep your session alive until the connection is re-established.

The Mosh service is distinct from SSH and must be installed and configured separately on your host system. Once the service is up and running, you can use it on your hosts in Termius.

{% hint style="info" %}
Termius uses its own library for Mosh compatibility. Mosh 1.3.0 and newer versions are supported.
{% endhint %}

{% tabs %}
{% tab title="Desktop" %}
To connect via Mosh on the desktop:

1. Open the `Vault` tab, then the `Hosts` screen
2. Click `New Host` or edit an existing one
3. In the `Host Details` screen, scroll down, and click `Show more` if you don't see the extra options<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FW65GHPLlCY6SFSY3nKkx%2FJump%20host01.png?alt=media&#x26;token=5c5ac65b-cef4-4526-acda-ab8072941988" alt=""><figcaption></figcaption></figure>
4. Enable `Mosh`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FjgU3fx2citd77MJBQ5nM%2FMosh01.png?alt=media&#x26;token=8367fc1f-e8ac-4b85-8899-9e53b9645d6f" alt=""><figcaption></figcaption></figure>
5. If your Mosh server is running on non-default ports, specify it accordingly:
   1. Default command for starting the mosh session: `mosh-server new -s -l LANG=en_US.UTF-8`
   2. In case you need to specify the custom port range: `mosh-server new -s -l LANG=en_US.UTF-8 -p [port from]:[port to]`
6. Termius auto-saves your host
7. Click `Connect`
   {% endtab %}

{% tab title="Mobile" %}
To connect via Mosh on mobile:

1. Create a host or edit an existing one<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FvQYOtJSuQE8D0jMkKhQr%2FiOS01.png?alt=media&#x26;token=bef45755-5dd3-4a89-b8e9-2311d05e3ef1" alt="" width="375"><figcaption></figcaption></figure></div>
2. Enable the `Use Mosh` setting<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F9kVYQry7VN2NtKMaunLm%2FProxy_iOS.png?alt=media&#x26;token=b153e158-823a-4174-b201-eb1e35a4434a" alt="" width="375"><figcaption></figcaption></figure></div>
3. If your Mosh server is running on non-default ports, specify it accordingly:
   1. Default command for starting the mosh session: `mosh-server new -s -l LANG=en_US.UTF-8`
   2. In case you need to specify the custom port range: `mosh-server new -s -l LANG=en_US.UTF-8 -p [port from]:[port to]`
4. Tap `Save`
5. Tap your host to `Connect`
   {% endtab %}
   {% endtabs %}

## Telnet

{% tabs %}
{% tab title="Desktop" %}

1. Open the `Vault` tab, then the `Hosts` screen
2. Click `New Host` or edit an existing one
3. In the Host details screen, scroll down and click `+ Add Telnet`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FM388NtXWh6kyFaKl0der%2FTelnet01.png?alt=media&#x26;token=053e2af2-39d8-45c8-b05c-1e2da06fc7a4" alt=""><figcaption></figcaption></figure>
4. Enter the port, username, and password. Termius auto-saves your host<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2F469FpRsmjBHy0J9pjvuk%2FTelnet01-1.png?alt=media&#x26;token=a86b9bdc-0969-4ea4-ae12-e87eb237a5e5" alt=""><figcaption></figcaption></figure>
5. Click `Connect`
   {% endtab %}

{% tab title="Mobile" %}

1. Create a host or edit an existing one<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FvQYOtJSuQE8D0jMkKhQr%2FiOS01.png?alt=media&#x26;token=bef45755-5dd3-4a89-b8e9-2311d05e3ef1" alt="" width="375"><figcaption></figcaption></figure></div>
2. In the `Edit Host` screen, scroll down, and toggle `Telnet`<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FoJ8KjeO9mYFQBpm3jzXE%2FiOS_telnet01.png?alt=media&#x26;token=514be532-ba28-4b69-9393-e26fc14393db" alt="" width="375"><figcaption></figcaption></figure></div>
3. Enter the port, username, and password<br>

   <div align="left"><figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FCNbaKihQkYE7H478kul3%2FiOS_telnet02.png?alt=media&#x26;token=95cb353d-f50e-4ed9-808c-072f989012bd" alt="" width="375"><figcaption></figcaption></figure></div>
4. Tap `Save`
5. Tap your host to `Connect`
   {% endtab %}
   {% endtabs %}

{% hint style="warning" %}
Telnet transmits data in plaintext, so avoid using it for sensitive information.
{% endhint %}

## Serial

Termius lets you connect to switches and routers over a serial port using a single cable: [Redpark's USB-C Serial Cable (C4-RJ45V)](https://redpark.com/usb-c-console-cable/) or [Redpark's Lightning Console Cable (L2RJ45V3)](https://redpark.com/lightning-console-cable-l2-rj45v/).

{% tabs %}
{% tab title="Desktop" %}

1. Open the `Vault` tab, then the `Hosts` screen
2. Click the `Serial` button, or use the hotkey `Cmd+Option+S/CTRL+Alt+S`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FP4YLTXR4kc7CFCenDKOp%2FSerial01.png?alt=media&#x26;token=d0befc69-1d45-4b93-8009-c81a51bc3318" alt=""><figcaption></figcaption></figure>
3. Choose the serial port you want to connect to<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FdBXmHeFFoVSvQ5Sdjsjr%2FSerial02.png?alt=media&#x26;token=4b422189-e8dc-4752-8763-907a10bbf307" alt=""><figcaption></figcaption></figure>
4. e the required configuration: baud rate, data bits, stop bits, flow control, and parity<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2Fit7oGh4spzK7nvcyf2ll%2FSerial03.png?alt=media&#x26;token=8bab2045-9760-41ae-9e66-82084c500b87" alt=""><figcaption></figcaption></figure>
5. Click `Connect`

{% hint style="warning" %}
If you experience issues with serial connections in Termius downloaded from the Microsoft Windows Store, install Termius from our website instead - [Download Windows](https://termius.com/download/windows)
{% endhint %}
{% endtab %}

{% tab title="Mobile" %}

1. Open the `Connections` tab
2. Tap the `Search` field or just scroll down to the bottom
3. Select `Start a serial connection`
4. Enter the required configuration: baud rate, data bits, stop bits, flow control, and parity
5. Tap `Connect`
   {% endtab %}
   {% endtabs %}

## Local Terminal

To open a local terminal:

1. Open the `Vault` tab, then the `Hosts` screen
2. Click the `Terminal` button or use the hotkey `CTRL/Cmd+L`<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2FBoGebvwBanqG0wRqsuJv%2FTerminal01.png?alt=media&#x26;token=e5d51ed6-9329-4a8c-b489-7d3c3aedab35" alt=""><figcaption></figcaption></figure>

By default, the local terminal uses a shell specified in the system's settings. You can choose a different shell in settings:

1. Open `Termius > Settings > Terminal`
2. Scroll down to the `Local Terminal Path` section. Choose the preferred shell:<br>

   <figure><img src="https://1830966906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PCLq8V6ZExygzYl6XVJ%2Fuploads%2Fkkm8HYdnZ1tqjq4DpvoW%2FTerminal02.png?alt=media&#x26;token=35f4e19b-4f19-4d58-a5c4-562546262881" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Termius from the Mac App Store and Snap Store do not include the Local Terminal feature due to sandbox limitations. Download Termius from the website for [macOS](https://termius.com/download/macos), [Windows](https://termius.com/download/windows), or [Linux](https://termius.com/download/linux) to use Local Terminal.
{% endhint %}


---

# 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/organize-and-connect-to-hosts/connecting-to-a-server.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.
