Can I install Harbor with Homebrew?
Yes. It’s one command:
brew install --cask harbormynotes/harbor/harbor-notes
That puts Harbor in your Applications folder. It needs macOS 15 Sequoia or later.
Don’t use Homebrew? You don’t need it. The download for Mac is the same app.
It’s the same app as the download
Homebrew installs the same app you’d get from our download page, signed by us and notarized by Apple. It isn’t the Mac App Store version, and that shows up in two places:
- It updates itself. Harbor checks for updates on its own, the same as the download, so you don’t need
brew upgrade. More on updating. - There’s no Sign in with Apple button. Apple only allows it in Mac apps from the App Store. If that’s how you signed up, here’s how to get in.
Already have Harbor from the Mac App Store? Then you’re set. Don’t install both. Each one is Harbor.app in your Applications folder, so only one fits. To switch, delete the App Store copy first, then run the command. Your notes live in your account, not in the app, so nothing’s lost. More on switching.
Uninstalling
brew uninstall --cask harbor-notes
That removes the app. Your notes stay in your account, and Harbor’s files on this Mac stay put in case you install it again.
To clear those files too, add --zap. That removes the app plus Harbor’s offline copy of your notes, its caches and its settings on this Mac. They go to the Trash. Nothing in your account is touched, so sign in anywhere and it’s all there.
Before you zap, open Harbor and let it sync if you’ve been working offline. Changes that never reached our servers only exist in those files. Then quit Harbor and run:
brew uninstall --zap --cask harbor-notes
Handing the Mac to someone else? Sign out of Harbor before you zap. Your sign-in lives in the Mac’s keychain, and --zap leaves it there.
The CLI is a separate install
Homebrew also has the Harbor command-line tool. That’s its own formula:
brew install harbormynotes/harbor/harbor
The names are close, so watch for it: harbor-notes with --cask is the app, and plain harbor is the CLI. Neither needs the other.
Related questions
Need more help?
Still stuck? Send us a message and a real person will get back to you.