Skip to content

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

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

ActionShortcut
Open Dashboard⌘⇧E
Rescan Projects⌘R
Settings⌘,
Quit⌘Q

Data Storage

Expose stores data in these locations:

TypeLocation
Preferences~/Library/Preferences/com.basique.Expose.plist
App Support~/Library/Application Support/Expose/
Cache~/Library/Caches/com.basique.Expose/
KeychainmacOS Keychain (API keys, tokens)

Resetting Preferences

To reset all preferences:

Terminal window
# Remove preferences
defaults delete com.basique.Expose
# Remove app support
rm -rf ~/Library/Application\ Support/Expose
# Remove cache
rm -rf ~/Library/Caches/com.basique.Expose

Then 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