Skip to content

General Settings

StormTunnel → Settings (Cmd+,) → General tab

General Settings Window

Startup & System

Setting Description Default
Launch at Login Start StormTunnel automatically when you log in Off
Show Status in Menu Bar Display connection status and quick actions in the menu bar On

Connection

Setting Description Default
Connection Timeout Maximum wait time for SSH connections. Range: 10--120 seconds, in 10-second increments. 30s

Lower values detect failures faster but may time out on slow networks. Higher values suit unreliable connections but delay error reporting.

Key Management

Setting Description Default
Show Stale Validation Warnings Warn when an SSH key hasn't been validated in over 30 days On

Notifications

Setting Description Default
Prefer Toasts When App is Active Show in-app toast notifications instead of system banners when the window is visible On
Show System Notifications Display macOS notification center banners when the app is in the background On
Always Show Critical Errors as System Notifications Force critical errors (auth failures, security warnings, license expiration) to system notifications regardless of app state On
Enable Notification Sounds Play sound effects for connection events and alerts On

Notification Routing

App State Toast Pref System Notif Result
Active On On Toast (non-critical), System + Toast (critical)
Active On Off Toast only
Active Off On System only
Active Off Off None
Background Any On System only
Background Any Off None

All settings take effect immediately. No restart required.