Desktop App (macOS)
Install, update, and troubleshoot the Teak desktop app on Apple Silicon Macs
Teak Desktop gives you a native macOS app with automatic updates and the same real-time sync as web and mobile.
macOS Apple SiliconRequirements
- macOS 13.0 or newer
- Apple Silicon Mac (M1, M2, M3, or newer)
- Internet connection for sign-in and sync
Install
Download
Download the latest macOS build from GitHub Releases.
Open the disk image
Open the .dmg file.
Install
Drag Teak.app to Applications.
Launch
Launch Teak from Applications.
First Launch Security Checks
Teak desktop releases are signed and notarized.
If Gatekeeper blocks launch:
Open Privacy & Security
Open System Settings → Privacy & Security.
Allow Teak
Find the Teak block message and choose Open Anyway.
Relaunch
Relaunch Teak.
Sign In
Desktop sign-in opens a secure browser-based authentication window and returns you to the app automatically after login. The desktop app keeps its own session, so signing out on desktop does not sign you out of Teak in your browser.
Teak Menu
The Teak menu in the macOS menu bar exposes these actions:
| Item | What it does |
|---|---|
| About Teak | Shows the installed version, copyright, and app icon |
| Check for Updates… | Manually checks for new versions and shows a notification while checking |
| Settings… | Opens the Settings panel (account info, API keys, billing) |
| Log Out | Signs you out and returns to the login screen |
Settings
Open Teak menu → Settings… to manage your account:
- Account: View your email address and card count.
- Upgrade / Billing: Upgrade to Pro or open the customer portal to manage your subscription.
- API Keys: Generate API keys for the Teak API and Raycast extension.
- Import/Export Data: Import bookmarks, a Raindrop CSV, or a Teak archive, and start, cancel, and download a portable data export.
- Appearance: Switch between Auto, Light, and Dark themes. Auto follows your macOS system appearance.
- Sign Out: Ends your desktop session and returns to the login screen.
- Delete Account: Opens
app.teakvault.com/settingsin your browser to complete account deletion.
Auto Updates
Teak checks for updates on each launch via GitHub Releases.
- If an update is available, you’ll see a prompt asking whether to download now or later.
- During download, a macOS notification and a percent badge on the Dock icon show progress.
- After download completes, you’ll see a prompt to restart now or later to install the update.
- If update checks fail (for example network outage), Teak continues running and retries on next launch.
Manual Update / Recovery
If you need to update manually or recover from a failed install:
Quit
Quit Teak.
Download
Download the latest release from GitHub Releases.
Replace
Replace Teak.app in Applications.
Relaunch
Relaunch Teak.
Rollback
If a release is unstable:
Download prior release
Download the prior stable release from GitHub Releases.
Replace
Replace Teak.app in Applications with that version.
Relaunch
Relaunch Teak.
Your account data stays in Teak backend storage and local session state is preserved unless you sign out.
Troubleshooting
App opens but cannot sign in
- Check your network connection.
- Confirm your system clock is correct.
- Retry after a minute in case of a temporary authentication issue.
An update does not apply
- Relaunch the app and wait for the update check.
- Confirm GitHub Releases is reachable from your network.
- On a very old build, install the latest release manually from GitHub.
Still stuck?
Reach out via Support.