Skip to content

Settings Reference

Complete reference for all StormTunnel settings and preferences.

Accessing Settings

Methods to open Settings:

  • Main Window: Click gear icon (⚙️) in toolbar
  • Menu Bar: StormTunnel → Settings
  • Keyboard: Press ⌘, (Command + Comma)

Settings Tabs

StormTunnel uses native macOS Settings with six organized tabs:

Tab Shortcut Description
General ⌘1 Startup, notifications, system integration
AWS ⌘2 AWS Session Manager and SSO configuration
License ⌘3 License activation and management
Known Hosts ⌘4 SSH host key management
Advanced ⌘5 Debug options, history, developer features
About ⌘6 Application information and resources

Quick Reference

General Settings

Setting Default Description
Launch at Login Off Start automatically on macOS login
Show in Menu Bar On Display icon in menu bar
Connection Timeout 30s Wait time for SSH connections (10-120s)
Show Notifications On Enable desktop notifications
Enable Sounds On Play notification sounds

Security Settings

Setting Default Description
Keychain Integration On Store passwords in macOS Keychain
Isolate Known Hosts On Use app-scoped known hosts file
SSH Key Authentication On Prefer SSH keys over passwords

Connection Settings

Setting Default Description
Connection Timeout 30s Wait time for SSH connections (10-120s)
Auto-Reconnect On Automatically reconnect on connection loss
Retry Attempts 3 Number of reconnection attempts
Retry Delay 5s Delay between reconnection attempts

Notification Settings

Setting Default Description
Show Notifications On Enable desktop notifications
Enable Sounds On Play notification sounds
Notify on Connect On Show notification when tunnel connects
Notify on Disconnect On Show notification when tunnel disconnects

Advanced Settings

Setting Default Description
Verbose SSH Output Off Show detailed SSH logs
Debug Mode Off Enable debug-level logging
History Events 50 Events stored per tunnel (20-200)
History Retention 30 days How long to keep history (7-90 days)

Debug Options

Setting Default Description
Verbose Logging Off Enable detailed logging for troubleshooting
Debug Mode Off Enable developer debug features
SSH Verbose Output Off Show raw SSH output in logs

Keyboard Shortcuts

Action Shortcut
Open Settings ⌘,
General Tab ⌘1
AWS Tab ⌘2
License Tab ⌘3
Known Hosts Tab ⌘4
Advanced Tab ⌘5
About Tab ⌘6

Data Locations

Data Location
Preferences ~/Library/Containers/in.rs.olujic.StormTunnel/Data/Library/Preferences/
SSH Keys ~/Library/Application Support/StormTunnel/SSH/
Known Hosts ~/Library/Application Support/StormTunnel/SSH/known_hosts

Reset Settings

To reset your StormTunnel preferences:

  1. Reset preferences only (keeps your tunnels):

    • Quit StormTunnel completely
    • Contact your system administrator to reset app preferences
    • Or, manually delete the preferences file from ~/Library/Containers/in.rs.olujic.StormTunnel/Data/Library/Preferences/

  2. Complete reset (removes everything including tunnels):

    • Quit StormTunnel completely
    • Open Finder
    • Press ⌘Shift G (Go to Folder)
    • Type: ~/Library/Containers/
    • Find in.rs.olujic.StormTunnel folder
    • Drag it to Trash
    • Empty the Trash

Note: Ask your administrator for help if you're unfamiliar with file management.

Best Practices

Security

  1. Use SSH keys over passwords
  2. Enable Keychain integration
  3. Use app-scoped known hosts
  4. Keep StormTunnel updated

Performance

  1. Set appropriate connection timeouts
  2. Limit history retention to 30 days
  3. Clear history periodically if needed