FAQ and support

Quick answers first. If yours isn’t here, write to us: a person reads every email, and we usually reply within a couple of business days.

Get the macOS Dock back

Turn off Hide the macOS Dock while Harbor runs in Settings › General, or just quit Harbor.

All the ways, including a Terminal command

Lost your license key?

We’ll email it to your purchase address. Or sign in to your account to see your keys and Macs.

Get your key · Your account

Common questions

How do I change or move things in the dock?

There’s no edit mode: hold anything and drag it. Right-click any widget for its size, colours and settings, or right-click the bar for its theme, size, spaces, auto-hide and Settings. To add something, right-click the bar and choose Add Widget, or drop apps, folders and files from Finder onto the dock.

How do I make an App Folder?

Right-click an app in the dock and choose Move to Folder › New Folder, or add “App Folder” from Add Widget. Drag more apps onto the folder tile. Its settings choose how it opens: grid, list, row or right in the dock.

How do spaces and multiple displays work?

Each space is a page of widgets. Switch with a sideways two-finger swipe on the dock, the page dots above it, or ⌃⌥⌘ plus the left or right arrow. Each display shows its own page. Manage them in Settings › Spaces, where you can also start a space from a template and export your setup.

The weather widget says “Set City”.

Right-click it, open its settings and type a city, or allow Location access to use where you are.

The calendar widget says “Allow Access”.

Click it and allow Calendars when macOS asks. If you said no before, open System Settings › Privacy & Security › Calendars and turn Harbor on. Settings › Permissions in Harbor shows everything in one place.

How does the Claude usage widget work?

It reads the usage logs Claude Code keeps on your Mac, so token counts need no sign-in. For your plan’s limits, open the widget’s settings and choose Sign in to Claude, or let it use Claude Code’s own sign-in. Your session is kept in your Mac’s keychain and is never sent to us.

How do Edge Notes work with Apple Notes?

Each Edge Note is one of your Notes widgets. Turn Edge Notes on or off and choose which display shows them in Settings › General. Opening a note picks up changes you made in the Notes app.

Minimized windows don’t show up in the dock.

Add the Minimized Windows widget, then allow Accessibility in Settings › Permissions. With that on, clicking an app also brings back its minimized windows.

How do updates work?

Harbor updates itself; you can turn this off in Settings › Updates. Every 1.x update is free. The newest version is always on the download page.

How do I move my license to a new Mac?

Each license works on 3 Macs at once. On the old Mac open Settings › License and choose Deactivate This Mac. If you don’t have the old Mac any more, sign in to your account and remove it there.

How do I manage my purchase?

Manage your purchase: sign in with your purchase email at your account. We send a one-time code, so there’s no password to remember. You can see your keys and Macs, remove a Mac, and have your keys emailed again.

Does Harbor work offline?

Yes. A license checks in with our server about once a month and keeps working for up to 60 days without a connection. Weather and Claude usage need the internet; everything else doesn’t.

What happens when my trial ends?

Harbor keeps working as a dock: apps, App Folders, the Trash, the clock and dividers. Other widgets show a note until you buy a license. Nothing you set up is deleted.

Where does Harbor keep my settings?

In ~/Library/Application Support/Harbor: your layout in layout.json, preferences and themes next to it. To keep a copy or move to another Mac, use Settings › Spaces › Export Setup.

Contact us

Email support@harbordock.app. To help us help you quickly, include:

  • Your Harbor version (Settings › About) and your macOS version.
  • What you did, what you expected, and what happened instead. A screenshot helps a lot.
  • For crashes or odd behaviour, Harbor’s log file: in Finder choose Go › Go to Folder, paste ~/Library/Logs/Harbor.log, and attach the file.

For license questions, write from your purchase email or include your order number. Please never send us your Mac password.