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.
Requirements
- macOS 13.0 or newer
- Apple Silicon Mac (M1, M2, M3, or newer)
- Internet connection for sign-in and sync
Install
- Download the latest macOS build from GitHub Releases.
- Open the
.dmgfile. - Drag Teak.app to Applications.
- Launch Teak from Applications.
First Launch Security Checks
Teak desktop releases are signed and notarized.
If Gatekeeper blocks launch:
- Open System Settings → Privacy & Security.
- Find the Teak block message and choose Open Anyway.
- Relaunch Teak.
Sign In
Desktop sign-in opens a secure browser-based authentication window and returns you to the app automatically after login.
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 |
| Settings… | Opens the Settings panel (account info, API keys, billing) |
| Check for Updates… | Checks for a new release and shows an interactive install dialog |
| 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.
- 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 silently on each launch.
- If an update is available, it is downloaded and installed automatically.
- The app will attempt to restart automatically. If it does not, close and relaunch Teak to use the new version.
- If update checks fail (for example network outage), Teak continues running and retries on next launch.
You can also trigger an update check manually at any time via Teak menu → Check for Updates… on macOS.
An interactive dialog appears showing the available version and release notes. You can choose to install immediately or defer.
Manual Update / Recovery
If you need to update manually or recover from a failed install:
- Quit Teak.
- Download the latest release from GitHub Releases.
- Replace Teak.app in Applications.
- Relaunch Teak.
Rollback
If a release is unstable:
- Download the prior stable release from GitHub Releases.
- Replace Teak.app in Applications with that version.
- 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 network connectivity.
- Confirm your system clock is correct.
- Retry after a minute in case of temporary auth service issues.
Update does not apply
- Relaunch the app and wait for update check.
- Confirm
teakvault.com/updatesis reachable from your network. - If you are on a build older than 1.0.22, it may still point to the legacy
updates.teakvault.comhost, which is no longer active. Install the latest release manually from GitHub to restore auto-updates.
Still stuck?
Reach out via Support.