Preferences
Access preferences by clicking the gear icon in the main window or selecting Settings from the menu bar.
General
Scan Directories
Directories to scan for projects:
- Click + to add a directory
- Click − to remove a directory
- Expose scans recursively
Launch at Login
Start Expose automatically when you log in.
Stop Servers on Quit
When enabled, Expose stops all managed servers when you quit the app. Disable this to keep servers running after Expose closes.
Account
Server URL
The URL of your Expose server:
- Must include protocol (
https://) - Example:
https://api.yourdomain.com
Tunnel Domain
The base domain for tunnel URLs:
- Don’t include protocol
- Example:
expose.yourdomain.com
User Info
- Email: Your account email
- Sign Out: Disconnect from the server
API Keys
- View your API keys
- Create new keys
- Revoke existing keys
Appearance
Menu Bar Icon
Choose what the menu bar icon displays:
- Default: Expose logo
- Tunnel Count: Number of active tunnels
- Status Dot: Green when connected
Window Behavior
- Show in Dock: Display Expose in the Dock when the window is open
- Float on Top: Keep the window above other windows
Keyboard Shortcuts
| Action | Shortcut |
|---|---|
| Open Dashboard | ⌘⇧E |
| Rescan Projects | ⌘R |
| Settings | ⌘, |
| Quit | ⌘Q |
Data Storage
Expose stores data in these locations:
| Type | Location |
|---|---|
| Preferences | ~/Library/Preferences/com.basique.Expose.plist |
| App Support | ~/Library/Application Support/Expose/ |
| Cache | ~/Library/Caches/com.basique.Expose/ |
| Keychain | macOS Keychain (API keys, tokens) |
Resetting Preferences
To reset all preferences:
# Remove preferencesdefaults delete com.basique.Expose
# Remove app supportrm -rf ~/Library/Application\ Support/Expose
# Remove cacherm -rf ~/Library/Caches/com.basique.ExposeThen restart Expose.
Troubleshooting
Settings Not Saving
- Check disk permissions
- Restart Expose
- Remove and re-add the preference
Keychain Access Denied
- Open Keychain Access
- Find “Expose” entries
- Grant access or delete and re-authenticate