Skip to content

Import & Export

Backup, share, and migrate your tunnel configurations.

Quick Reference

Export Tunnels

  1. File -> Export (Cmd+E)
  2. Choose save location
  3. Click Export

Import Tunnels

  1. File -> Import (Cmd+I)
  2. Select the file
  3. Choose Merge or Replace All
  4. Click Import

Exporting

Basic Export

Exports all tunnels with default settings (no passwords, no SSH keys):

  1. File -> Export (or Cmd+E)
  2. Choose where to save
  3. Click Export

Export Options

For more control, use File -> Export Options:

Option Description Default
All Tunnels Export everything On
Selected Tunnels Choose specific tunnels
Include Passwords Export saved passwords Off
Include SSH Keys Export key file paths Off
Compress Smaller file size Off
Encrypt (Premium) AES-256 encryption Off

Password Security

If including passwords, enable Encrypt Output to protect them.

Encrypted Export (Premium)

  1. Enable Encrypt Output in export options
  2. Enter a strong password
  3. Store the password separately from the export file

Importing

Import Modes

Merge (Default):

  • Adds new tunnels
  • Updates existing tunnels with same ID
  • Keeps tunnels not in the file

Replace All:

  • Removes all existing tunnels
  • Imports only what's in the file

Conflict Resolution

When tunnels conflict, choose:

Option What Happens
Keep Existing Don't import the conflicting tunnel
Replace Overwrite with imported version
Import as New Create copy with different name

Importing Encrypted Files

  1. StormTunnel detects encryption automatically
  2. Enter the password used during export
  3. File decrypts and imports normally

Lost Password

There is no recovery for encrypted exports. If you lose the password, the file cannot be imported.

Common Use Cases

Personal Backup

  • Export monthly with date in filename (backup-2025-12.json)
  • Include passwords only if encrypted
  • Store in a secure location

Team Sharing

  • Export selected tunnels only
  • Do not include passwords
  • Include SSH key paths (recipients use their own keys)

New Mac Setup

  1. Export all tunnels (encrypted if including passwords)
  2. Transfer file to new Mac
  3. Import with Replace All
  4. Verify tunnels connect

What Gets Exported

Included Not Included
Tunnel names and settings Passwords (unless enabled)
Host, ports, connection type Private SSH keys (only paths)
AWS configuration AWS credentials

Keyboard Shortcuts

Action Shortcut
Export Cmd+E
Import Cmd+I