Skip to content

SSH Config Autocomplete

Create tunnels from your existing ~/.ssh/config hosts.


Using SSH Config Hosts

Create a Tunnel from Config

  1. Click Add Tunnel (or Cmd+N)
  2. In the Name field, click the server icon button
  3. Select a host from the dropdown
  4. Fields populate automatically from your SSH config

What Gets Populated

Field Source in SSH Config
Tunnel Name Host alias
Tunnel Type Set to SSH
SSH Hostname Host alias (SSH resolves)
Username User directive
SSH Port Port directive
Local Port LocalForward (local)
Remote Host LocalForward (remote)
Remote Port LocalForward (port)
SSH Key IdentityFile (matched)

SSH Config Format

StormTunnel supports standard SSH config directives:

Host my-server
    HostName 192.168.1.100
    User admin
    Port 2222
    IdentityFile ~/.ssh/my-key
    LocalForward 8080 localhost:80

Supported Directives

Directive Description
Host Alias name (appears in dropdown)
HostName Actual server address
User SSH username
Port SSH port (default: 22)
IdentityFile Path to SSH private key
LocalForward Port forwarding configuration

Wildcard Patterns

Hosts with wildcards (*, ?) are excluded from the dropdown:

# These appear in the dropdown
Host production-db
Host staging-api

# These are excluded (wildcards)
Host *
Host *.example.com

Identity File Matching

If your SSH config specifies an IdentityFile, StormTunnel matches it with your imported keys:

  1. Reads the IdentityFile path from config
  2. Searches imported keys for a matching file path
  3. If found, selects that key automatically

Import Keys First

Import your SSH keys via SSH Key Management (Cmd+K) before creating tunnels so automatic matching works.


Example SSH Config

# Development server
Host dev
    HostName dev.example.com
    User developer
    IdentityFile ~/.ssh/dev-key

# Production database tunnel
Host prod-db
    HostName bastion.example.com
    User admin
    Port 2222
    IdentityFile ~/.ssh/prod-key
    LocalForward 5432 db.internal:5432

# Staging API
Host staging-api
    HostName staging.example.com
    User deploy
    LocalForward 8080 localhost:3000