Help
How to set ShareKeeper up, and what to do when a folder won’t connect.
Getting started
- Install. Download ShareKeeper, open the disk image and drag ShareKeeper to Applications. Open it, and its icon appears in the menu bar.
- Add a server. Click the menu bar icon, then the gear button at the bottom of its window to open Settings, and choose Add Server… in the sidebar. Pick one of the servers ShareKeeper finds on your network, or type an address such as
nas.local,smb://192.168.1.10,nfs://nas.localorhttps://dav.example.com. - Sign in. Use a name and password, connect as a guest, or use your Mac’s Kerberos ticket if your organization has one. If Finder already saved a password for the server, ShareKeeper offers to use it. Passwords go in your login keychain.
- Choose folders. ShareKeeper lists the folders the server offers. For each one, choose Keep connected to have it connected whenever the server can be reached, or On demand to connect it only when you ask.
- Start with your Mac. In Settings, turn on Open at Login at the bottom of the sidebar.
Optional extras live in each server’s settings: an away address for use outside your home network (Tailscale, a VPN or a public name), rules for when to connect, and Wake-on-LAN. Each folder’s options have where it appears, whether it shows in Finder’s sidebar, and actions to run when it connects.
Local Network access
macOS asks whether ShareKeeper may find and connect to devices on your local network the first time it needs to, usually when you add your first server. Choose Allow.
ShareKeeper uses this access to check that your servers can be reached, list their folders, find servers with Bonjour and send Wake-on-LAN. Connecting a folder is done by macOS itself, but ShareKeeper relies on those checks to know when to connect.
If you chose Don’t Allow
ShareKeeper says “ShareKeeper can’t see your network”, in the menu bar window and in Add Server. To fix it:
- Choose Open Privacy Settings in that message, or open System Settings → Privacy & Security → Local Network.
- Turn on ShareKeeper.
- Go back to ShareKeeper. It notices the change on its next check; Retry now checks straight away.
Where folders appear
- Direct edition (downloaded from this site): in a folder of its own,
~/Network/<Server>/<Folder>, at the same path every time. To keep them somewhere other than~/Network, use Folder location in Settings → General. To have one folder appear in/Volumeslike Finder instead, change Where it appears in that folder’s options. - Mac App Store edition: in
/Volumes, as Finder does it. If another drive already uses the same name, macOS adds “-1” to the new one, and ShareKeeper tells you.
Each folder also has a setting to show or hide it in Finder’s sidebar.
Licenses and purchases
The free trial
The Direct edition is free for 14 days from the first time you open it. In the Mac App Store edition, choose Start Free Trial on the License page; the 14 days start then. When the trial ends, folders stop connecting until you buy ShareKeeper. Anything already connected stays connected, and Settings, ejecting and Activity keep working.
Entering a license key
After you buy ShareKeeper, Polar emails you a license key. In ShareKeeper, go to Settings → License, choose Enter License… and paste it. The page you see after checkout can also open ShareKeeper with the key filled in.
Using more than one Mac
A key works on up to 3 Macs at a time. To free one, choose Deactivate this Mac on the License page, or remove a Mac you no longer have with Manage licenses, which opens the license portal in your browser.
ShareKeeper checks the key about once a week and stays licensed while you’re offline. It only removes a key when the license server says it’s no longer valid, for example after a refund.
Bought it on the App Store?
Your purchase includes the Direct edition. Here’s how to get a license key for it. In the App Store edition, Restore Purchases on the License page brings your purchase to another Mac signed in with the same Apple Account.
Troubleshooting
The menu bar window shows one line under each folder saying what it’s doing. Activity, opened with the button at the bottom of that window, has the full story, with the technical log under each entry.
A folder won’t connect
Check the line under the folder and its server. “Reconnects when … is back” and “Offline since …” mean the server didn’t answer: make sure it’s switched on and that you’re on its network, or that its away address is set up. ShareKeeper keeps trying, more slowly the longer the server is away (up to every 5 minutes); Retry now tries immediately.
The server rejected the password
ShareKeeper stops trying after the first rejection, so that repeated attempts don’t lock the account. Choose Update Password… and enter the current one. If you changed it on the server, use the new password.
A folder says “Paused”
You ejected it, in Finder or with Eject All, so ShareKeeper leaves it alone. Choose Resume to have it connect again.
A folder is held back by a rule
A connection rule is stopping it, for example “home networks only”, or holding off while you’re on a phone hotspot or on battery. The message names the rule. Change the rules in the server’s connection settings.
Finder says “Server connections interrupted” after sleep
Turn on Clean up dead connections after sleep in Settings → General. After the Mac wakes, ShareKeeper then disconnects folders whose server doesn’t answer, before Finder gets stuck on them, and connects them again when the server is back.
A folder appears as “Media-1”
Another drive in /Volumes already had that name, often a stale connection made in Finder. Eject the other drive; the next time ShareKeeper connects the folder, it gets its own name back. In the Direct edition, fixed folder locations avoid this altogether.
“This key is already active” on a new Mac
The key is in use on 3 Macs. Deactivate it on one you no longer use, or in the license portal (Manage licenses).
Getting updates
The Direct edition checks for updates once a day if you allowed it to, and shows what’s new before it installs one. Check for Updates… in the ShareKeeper menu, or in the menu bar window’s Control-click menu, checks now. The App Store edition updates through the App Store.
Contact
Write to support@sharekeeper.app. If something went wrong, include the entry from Activity: expand it and choose Copy next to its log. Logs never contain passwords, but they do name your servers and user names, so look them over before you send them.