Skip to content

Finding and Organizing Tunnels

Quickly find tunnels and keep your list organized.

Searching for Tunnels

Use the search box at the top of the tunnel list to filter tunnels instantly.

  1. Click the search box (or press Cmd+F)
  2. Type any part of the tunnel name
  3. Results filter as you type
  4. Press Esc or click X to clear
Search for Example
Tunnel name postgres, dev, prod
Service type ssh, aws
Host/IP 192.168, example.com

Search Examples

Type this To find
prod All production tunnels
postgres All PostgreSQL tunnels
aws All AWS Session Manager tunnels
dev- All tunnels starting with "dev-"

Combine Terms

Search aws prod to find AWS tunnels with "prod" in the name.

Organizing Your Tunnels

Use Clear Names

Name tunnels so they're easy to find and sort:

✅ Good names:
dev-postgres
staging-api
prod-redis

❌ Avoid:
tunnel1
database
my-server

Recommended format: [environment]-[service]

Archive Old Tunnels

When you no longer need a tunnel:

  1. Export it first (File → Export) as a backup
  2. Delete it from the list
  3. Your active list stays clean and fast

Keyboard Navigation

Work faster with keyboard shortcuts.

Essential Shortcuts

Action Shortcut
Search tunnels Cmd+F
Clear search Esc
New tunnel Cmd+N
Connect selected Space or Enter
Settings Cmd+,
Action Shortcut
Move up Up
Move down Down
Select tunnel Enter

See Keyboard Shortcuts for the complete list.

Understanding Status Colors

Quickly see tunnel status at a glance:

Color Status
🟢 Green Connected
⚫ Gray Disconnected
🟡 Yellow Connecting
🔴 Red Error (click for details)

Tips for Many Tunnels

When you have lots of tunnels, these strategies help:

Group by Naming

Use prefixes to group related tunnels:

aws-dev-postgres
aws-dev-redis
aws-prod-postgres
aws-prod-redis

Then search aws-dev to see only development AWS tunnels.

Regular Cleanup

Every few months:

  1. Export all tunnels as a backup
  2. Delete unused tunnels
  3. Rename any with unclear names

Quick Access via Menu Bar

For tunnels you use constantly:

  1. Enable Menu Bar in Settings → General
  2. Click the menu bar icon for instant access
  3. Connect/disconnect without opening the main window

Common Questions

Can't find a tunnel?

  1. Clear the search (press Esc)
  2. Scroll through the full list
  3. Check if it was deleted (look in Connection History)

Search seems slow?

With many tunnels, try:

  • More specific searches (aws-prod- instead of just prod)
  • Archive old tunnels you don't use

How to rename a tunnel?

  1. Right-click the tunnel
  2. Select Edit or Rename
  3. Change the name
  4. Save

Next Steps