Skip to main content

Import from Termius

Quick guide to import your Termius hosts to Xermius using the Copy Link feature.

Overview​

Termius provides a "Copy Link" feature that creates shareable URLs for hosts. Xermius can import these URLs directly!

What Gets Imported:

  • ✅ Host label/name
  • ✅ IP address or hostname
  • ✅ Port number
  • ✅ Username
  • ✅ Operating system → Group
  • ❌ Passwords (not in link)
  • ❌ SSH keys (not in link)
  • ❌ Snippets/commands
  • ❌ Port forwarding rules

Perfect for: Quick migration, sharing specific hosts, mobile to desktop migration

URL Structure​

https://account.termius.com/host-sharing#ip=192.168.1.100&port=22&label=Production%20Server&username=admin&os=linux

Parameters:

  • ip - IP address or hostname
  • port - Port number
  • label - Host display name
  • username - SSH username
  • os - Operating system (becomes group)

Single Host:

https://account.termius.com/host-sharing#ip=192.168.1.100&port=22&label=Web%20Server&username=admin&os=ubuntu

Multiple Hosts (one per line):

https://account.termius.com/host-sharing#ip=192.168.1.100&port=22&label=Web%20Server%201&username=admin&os=ubuntu
https://account.termius.com/host-sharing#ip=192.168.1.101&port=22&label=Web%20Server%202&username=admin&os=ubuntu
https://account.termius.com/host-sharing#ip=192.168.1.102&port=3306&label=Database&username=dbadmin&os=debian

Export from Termius​

Mobile App (iOS/Android)​

  1. Open Termius app
  2. Go to Hosts tab
  3. Select a host
  4. Tap ⋮ (menu) or Share icon
  5. Select "Copy Link"
  6. Link copied to clipboard!

For multiple hosts:

  • Repeat for each host
  • Paste links into a text file
  • One link per line

Desktop App​

  1. Open Termius on desktop
  2. Select host
  3. Right-click → Share → Copy Link
  4. Link copied!

Web App​

  1. Open Termius in browser
  2. Navigate to host
  3. Click share icon
  4. Copy link

Import to Xermius​

Create a text file with one link per line:

termius-hosts.txt:

https://account.termius.com/host-sharing#ip=192.168.1.100&port=22&label=Production%20Web&username=admin&os=ubuntu
https://account.termius.com/host-sharing#ip=192.168.1.101&port=22&label=Staging%20Web&username=admin&os=ubuntu  
https://account.termius.com/host-sharing#ip=db.example.com&port=3306&label=Database&username=dbadmin&os=debian
https://account.termius.com/host-sharing#ip=192.168.1.103&port=22&label=Dev%20Server&username=developer&os=linux

Step 2: Open Import Dialog​

  1. Open Xermius
  2. Click NEW HOST dropdown
  3. Select Import Hosts
  4. Click Termius tab
  1. Paste your links into the text area
  2. One link per line
  3. Click Preview button

Step 4: Preview & Confirm​

┌──────────────────────────────────────────────┐
│ Import Preview                               │
├──────────────────────────────────────────────┤
│ Found 4 Termius hosts                        │
│                                              │
│ ✓ Production Web                             │
│   admin@192.168.1.100:22                     │
│   Group: ubuntu                              │
│                                              │
│ ✓ Staging Web                                │
│   admin@192.168.1.101:22                     │
│   Group: ubuntu                              │
│                                              │
│ ✓ Database                                   │
│   dbadmin@db.example.com:3306                │
│   Group: debian                              │
│                                              │
│ ✓ Dev Server                                 │
│   developer@192.168.1.103:22                 │
│   Group: linux                               │
├──────────────────────────────────────────────┤
│        [Cancel]            [Import 4]        │
└──────────────────────────────────────────────┘
  1. Review hosts
  2. Notice OS becomes Group
  3. Click Import

Step 5: Complete Import​

✓ Successfully imported 4 hosts from Termius
  - 4 new hosts added
  - 3 groups created (ubuntu, debian, linux)
  - 0 duplicates skipped

Your Termius hosts are now in Xermius!

OS to Group Mapping​

Termius OS field → Xermius Group:

Termius OSXermius GroupNotes
ubuntuUbuntu
debianDebian
linuxLinuxGeneric
centosCentOS
fedoraFedora
redhatRedHat
windowsWindowsIf SSH enabled
macosmacOSIf SSH enabled

You can reorganize groups after import!

Post-Import Tasks​

1. Reorganize Groups​

OS-based groups may not be ideal:

Before (by OS):
├── ubuntu (10 hosts)
├── debian (5 hosts)
└── linux (3 hosts)

After (by function):
├── Production (8 hosts)
├── Staging (6 hosts)
└── Development (4 hosts)

How to:

  1. Select hosts
  2. Right-click → Edit
  3. Change group
  4. Save

2. Set Passwords/Keys​

Termius links don't include auth:

For each host:

  1. Right-click → Edit
  2. Add password OR select SSH key
  3. Save

Bulk edit:

  1. Select hosts with same auth
  2. Right-click → Bulk Edit
  3. Set password/key for all
  4. Save

3. Import SSH Keys​

If you used keys in Termius:

  1. Export keys from Termius:

    • Termius → Settings → Keychain
    • Export keys (if available)

  2. Import to Xermius:

    • SSH Keys tab → Import Key
    • Select exported keys

  3. Assign to hosts:

    • Edit each host
    • Select imported key
    • Save

4. Test Connections​

1. Start with one host per group
2. Click Connect
3. Enter password (if prompted)
4. Verify connection works
5. If successful, others should work too

Migration Strategies​

Strategy 1: Quick Start (Few Hosts)​

Best for: < 10 hosts

1. Open Termius mobile
2. Copy link for each host
3. Paste into Xermius import
4. Import all at once
5. Set passwords manually

Time: ~10 minutes

Strategy 2: Organized Migration (Many Hosts)​

Best for: 10-50 hosts

1. Group hosts by function in Termius
2. Export one group at a time
3. Create text file per group
4. Import groups separately
5. Maintain organization

Time: ~30 minutes

Strategy 3: Selective Migration​

Best for: Only migrating active hosts

1. List frequently used hosts
2. Only copy links for those
3. Import selective list
4. Add others later as needed

Time: ~5 minutes

Limitations & Workarounds​

❌ Passwords Not Included​

Why: Security - passwords aren't in shareable links

Workaround:

  1. Use SSH keys (recommended)
  2. Or manually add passwords after import
  3. Consider password manager integration

❌ SSH Keys Not Included​

Why: Keys are stored separately in Termius

Workaround:

  1. Export keys from Termius if possible
  2. Or use existing keys from ~/.ssh/
  3. Import to Xermius keychain
  4. Assign to hosts

❌ Snippets/Commands Not Migrated​

Why: Not included in Copy Link

Workaround:

  1. Document important snippets
  2. Recreate in Xermius Snippets feature
  3. Xermius snippets are more powerful!

❌ Port Forwarding Rules​

Why: Not in Copy Link format

Workaround:

  1. Document forwarding rules
  2. Recreate in Xermius
  3. Xermius has better UI for this!

❌ Folder Structure​

Why: Links are flat, no hierarchy

Workaround:

  1. OS field becomes group (basic organization)
  2. Manually reorganize after import
  3. Create nested groups in Xermius

Advantages of Xermius​

After migrating from Termius:

Better Organization:

✓ Nested groups (unlimited depth)
✓ Tags for multiple categorization
✓ Search and filters
✓ Custom views

Enhanced Features:

✓ Local terminal (test commands locally)
✓ Snippet library (100+ templates)
✓ Cloudflare tunnels (share localhost)
✓ SFTP file manager
✓ Port forwarding UI
✓ Connection tester

Desktop Power:

✓ Native performance
✓ Multiple tabs
✓ Split panes
✓ Keyboard shortcuts
✓ No subscription needed (Freemium)

Troubleshooting​

Invalid URL Format​

Problem: "Invalid Termius link"

Solution:

  • Check URL starts with https://account.termius.com/host-sharing#
  • Verify parameters are present: ip=, port=, etc.
  • No extra spaces or line breaks in URL

No Hosts Found​

Problem: Import shows "No valid hosts found"

Solution:

  • Check URLs are complete (not truncated)
  • Verify one URL per line
  • Remove empty lines
  • Check for ip= parameter in each URL

Special Characters in Labels​

Problem: Host names with weird characters

Solution:

  • Termius uses URL encoding (%20 for space)
  • Xermius decodes automatically
  • Edit host names after import if needed

Duplicate Hosts​

Problem: "Host already exists"

Solution:

  • Xermius checks for duplicates (by name + host)
  • Skip duplicates, or
  • Rename hosts in Termius before export

Example: Full Migration​

Let's migrate 5 Termius hosts:

Termius Hosts:

- prod-web-01 (192.168.1.100:22, admin)
- prod-web-02 (192.168.1.101:22, admin)
- stag-api (staging.example.com:8080, apiuser)
- dev-db (192.168.1.102:3306, dbadmin)
- jump-host (bastion.example.com:22, ubuntu)

Step 1: Export from Termius

On mobile, copy link for each:

https://account.termius.com/host-sharing#ip=192.168.1.100&port=22&label=prod-web-01&username=admin&os=ubuntu
https://account.termius.com/host-sharing#ip=192.168.1.101&port=22&label=prod-web-02&username=admin&os=ubuntu
https://account.termius.com/host-sharing#ip=staging.example.com&port=8080&label=stag-api&username=apiuser&os=linux
https://account.termius.com/host-sharing#ip=192.168.1.102&port=3306&label=dev-db&username=dbadmin&os=debian
https://account.termius.com/host-sharing#ip=bastion.example.com&port=22&label=jump-host&username=ubuntu&os=ubuntu

Step 2: Import to Xermius

  • Paste all links
  • Preview shows 5 hosts
  • Import

Step 3: Reorganize

Delete OS-based groups
Create new groups:
- Production (prod-web-01, prod-web-02)
- Staging (stag-api)
- Development (dev-db)
- Infrastructure (jump-host)

Step 4: Configure Auth

- Production servers: Import prod.key, assign to both
- Staging: Enter password
- Dev DB: Enter password
- Jump host: Import bastion.key

Step 5: Test

  • Connect to one host per group
  • Verify all work
  • Done!

Time: ~15 minutes for 5 hosts

Tips for Smooth Migration​

Before Export​

✅ Clean up Termius - Remove old/unused hosts
✅ Organize first - Group in Termius if possible
✅ Note passwords - Write down auth methods
✅ Export keys - Save SSH keys separately

During Export​

✅ One group at a time - Easier to organize
✅ Save links to file - Don't lose them
✅ Label clearly - Name text files by group

After Import​

✅ Test before deleting - Keep Termius until verified
✅ Reorganize immediately - Don't leave OS-based groups
✅ Set up keys - Better than passwords
✅ Explore features - Try snippets, tunnels, etc.

Quick tip: For mobile-to-desktop migration, copy all Termius links to a note app first, then paste into Xermius on desktop!