General Settings
StormTunnel → Settings (Cmd+,) → General tab

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.