# Import existing hosts

Termius supports several import options, allowing you to migrate your existing hosts to Termius.

## Import data

{% tabs %}
{% tab title="\~/.ssh/config file" %}
Termius supports importing the contents of the `~/.ssh` folder, including `ssh_config`, `known_hosts`, and key files:

1. Navigate to the **Hosts** screen and select `Import` from the `New Host` drop-down<br>

   <figure><img src="/files/SZx1nmGjoBSnR8WIGb9s" alt=""><figcaption></figcaption></figure>
2. Choose `~/.ssh` as the import source<br>

   <figure><img src="/files/qooXejTrc8UslXVD5Iiu" alt=""><figcaption></figcaption></figure>
3. Select the entities you want to import and click `Import`<br>

   <figure><img src="/files/HDbsa4Apn4XWjGO18HXm" alt=""><figcaption></figcaption></figure>
4. The imported entities will be added to your **Personal vault**

{% hint style="info" %}
There are a few limitations to be aware of:

* `ProxyCommand` is not supported and will be ignored
* `JumpHost` settings will be converted into a Host chain
* `IdentityFile` can only be imported with the Termius app downloaded directly from the website
  {% endhint %}
  {% endtab %}

{% tab title="CSV" %}
Termius can import hosts from a CSV file, including labels, IP addresses, protocols, ports, groups, subgroups, tags, and credentials.

#### Fill out the Termius CSV template first

1. Navigate to the **Hosts** screen and select `Import` from the `New Host` drop-down<br>

   <figure><img src="/files/SZx1nmGjoBSnR8WIGb9s" alt=""><figcaption></figcaption></figure>
2. Choose `CSV` as the import source<br>

   <figure><img src="/files/iMkpsg5BKJPjfDx0Anm0" alt=""><figcaption></figcaption></figure>
3. Download the template. Enter the information you want to import into the file. Ensure that each host's hostname or IP address is specified in the CSV file<br>

   <figure><img src="/files/2lCrKo2zT7tXPchqAkPD" alt=""><figcaption></figcaption></figure>

#### Import into Termius

When preparing a CSV file, make sure it matches the required format. Once ready, upload your file to import hosts into Termius:

1. Select `Import` from the `New Host` drop-down on the Hosts screen<br>

   <figure><img src="/files/SZx1nmGjoBSnR8WIGb9s" alt=""><figcaption></figcaption></figure>
2. Choose `CSV` as the import source, then click `Skip download`<br>

   <figure><img src="/files/mirBmQQpslbYhCClu0ST" alt=""><figcaption></figcaption></figure>
3. Drag and drop your file to Termius, then click `Continue`<br>

   <figure><img src="/files/svefdVC1CeqbLmAFplYB" alt=""><figcaption></figcaption></figure>
4. The imported entities will be added to your **Personal vault**
   {% endtab %}

{% tab title="PuTTY" %}
Termius can import connections, tunnels, and keys from PuTTY.

#### Import from PuTTY on Windows

Termius can automatically import your saved PuTTY sessions and convert them into hosts, so you can reuse your existing setup without recreating it:

1. Navigate to the **Hosts** screen and select `Import` from the `New Host` drop-down<br>

   <figure><img src="/files/SZx1nmGjoBSnR8WIGb9s" alt=""><figcaption></figcaption></figure>
2. Choose `PuTTY` as the import source<br>

   <figure><img src="/files/5lz7CLYeQR1CAChp7jnZ" alt=""><figcaption></figcaption></figure>
3. Select the entities you want to import and click `Import`<br>

   <figure><img src="/files/4d7Gv9dxzHN1ZmOBeMDZ" alt=""><figcaption></figcaption></figure>
4. The imported entities will be added to your **Personal vault**

***

#### Import from PuTTY on macOS and Linux

**1. Export from PuTTY**

If you want to transfer your PuTTY sessions to another system, export them as a file:

1. Open Windows PowerShell
2. Run the following command:\
   `reg export HKCU\Software\SimonTatham ([Environment]::GetFolderPath("Desktop") + "\putty.reg")`
3. Transfer the `putty.reg` file to your macOS or Linux device<br>

**2. Import into Termius**

Once you have the exported file:

1. Navigate to the **Hosts** screen and select `Import` from the `New Host` drop-down<br>

   <figure><img src="/files/SZx1nmGjoBSnR8WIGb9s" alt=""><figcaption></figcaption></figure>
2. Choose `PuTTY` as the import source, then drag and drop your **.reg** file<br>

   <figure><img src="/files/5lz7CLYeQR1CAChp7jnZ" alt=""><figcaption></figcaption></figure>
3. Select the entities you want to add to Termius and click `Import`<br>

   <figure><img src="/files/4d7Gv9dxzHN1ZmOBeMDZ" alt=""><figcaption></figcaption></figure>
4. The imported entities will be added to your **Personal vault**
   {% endtab %}

{% tab title="MobaXterm" %}
Termius can import sessions, folders, and SSH tunnels from MobaXterm.\
MobaXterm stores sessions in a configuration file, so you can transfer them by copying the `MobaXterm.ini` file and importing it into Termius.

#### 1. Export the configuration file

1. In MobaXterm, navigate to `Settings > Export configuration`
2. Select an option to export the entire MobaXterm configuration

#### 2. Import into Termius

1. Navigate to the **Hosts** screen and select `Import` from the `New Host` drop-down<br>

   <figure><img src="/files/SZx1nmGjoBSnR8WIGb9s" alt=""><figcaption></figcaption></figure>
2. Choose `MobaXterm` as the import source, then drag and drop your **.mobaconf** or **.mxtsession** file<br>

   <figure><img src="/files/XLDlGhdXir9fSgY6Nafn" alt=""><figcaption></figcaption></figure>
3. Enter the passphrase if the file is encrypted
4. Select the entities you want to import and click `Import`<br>

   <figure><img src="/files/PcRNNO4ZGFpuvOCVihFW" alt=""><figcaption></figcaption></figure>
5. The imported entities will be added to your **Personal vault**
   {% endtab %}

{% tab title="SecureCRT" %}
Termius can import hosts, groups, and credentials from SecureCRT.\
SecureCRT stores sessions as files on all platforms, so you can transfer them by copying the configuration folder and importing it into Termius.

#### 1. Export the configuration file

1. In SecureCRT, navigate to `Tools` > `Export settings`
2. Choose a file name and click `Export`

#### 2. Import into Termius

1. Navigate to the **Hosts** screen and select `Import` from the `New Host` drop-down<br>

   <figure><img src="/files/SZx1nmGjoBSnR8WIGb9s" alt=""><figcaption></figcaption></figure>
2. Choose `SecureCRT` as the import source, then drag and drop your **.xml** file<br>

   <figure><img src="/files/7iMl80kYKkLsTwH4WNa4" alt=""><figcaption></figcaption></figure>
3. Enter the passphrase if the file is encrypted
4. Select the entities you want to import and click `Import`<br>

   <figure><img src="/files/tngYfLhRXzK5tTLw4izw" alt=""><figcaption></figcaption></figure>
5. The imported entities will be added to your **Personal vault**
   {% endtab %}
   {% endtabs %}

## Organize your data

To keep your hosts structured and easy to manage, use **Groups** and **Vaults** to organize your infrastructure. This helps you separate environments, simplify navigation, and control access across your team.

Learn more in [Groups and tags](/organize-and-connect-to-hosts/groups-and-tags.md) and [Team vaults](/team-collaboration/team-vaults.md).


---

# 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/getting-started/import-existing-hosts.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.
