SSH Config Autocomplete¶
Create tunnels from your existing ~/.ssh/config hosts.
Using SSH Config Hosts¶
Create a Tunnel from Config¶
- Click Add Tunnel (or Cmd+N)
- In the Name field, click the server icon button
- Select a host from the dropdown
- 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:
- Reads the
IdentityFilepath from config - Searches imported keys for a matching file path
- 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