Support
Email support@tocloco.com. We usually reply within two working days.
When reporting a problem, it helps enormously to include which protocol you were using (SFTP, FTP or FTPS), the server software if you know it, and, for FTP issues, a copy of the server log from View → Server Log (⌘⇧K). Passwords are already redacted in it.
Where's my license? / I lost my license
If you bought Wharf on this website, your license key was emailed to the address you used at checkout, from licenses@wharf-app.com. Check your spam folder, or have it sent again. Mac App Store copies have no key; the App Store looks after them.
How do I enter my license?
Open Wharf and choose Wharf › Enter License…, or go to Settings › License. Paste the key, or the whole email (Wharf will find the key in it), and click Activate. The same key works on all of your own Macs.
Should I give Wharf Full Disk Access?
It's optional, and only applies to the edition from this website. Without it, macOS asks the first time Wharf opens Desktop, Documents, Downloads or an external drive. With it, Wharf can reach any folder without those prompts. Turn it on in System Settings › Privacy & Security › Full Disk Access, then reopen Wharf. Settings › License in Wharf shows whether it's on.
Wharf can't see my files
In the edition from this website, a folder macOS protects shows a banner with a button that opens Full Disk Access in System Settings (see above).
The Mac App Store edition runs in Apple's App Sandbox, which is required for apps on the Mac App Store. It can only read folders you have explicitly given it. Click the folder button at the top of the left pane, or the house button to grant access to your home folder. Once granted, everything inside it is available and the choice is remembered.
Dragging files in from Finder always works, with no permission needed.
It's asking me to verify a host key
That appears the first time you connect to a server, and it is a security check rather than an error. The fingerprint shown identifies the server. If you want to confirm it, run this on a machine you already trust:
ssh-keyscan -p 22 your-server.com | ssh-keygen -lf -
If the fingerprint matches, click Trust. Wharf will remember it and warn you loudly if it ever changes, which can mean the server was rebuilt, or that something is intercepting the connection.
Where are my passwords stored?
In your Mac's Keychain, never in a configuration file. Removing a site from Wharf removes its stored credentials too.
My FTPS server's certificate is rejected
Wharf checks that the certificate is valid and matches the hostname. If your server uses a self-signed certificate, edit the site and enable Allow untrusted certificate under Advanced. Only do this for a server you control: it disables the check that the server is who it claims to be.
Following a log shows nothing new
Wharf checks the file about once a second, so new lines appear with a short delay. If the file is rotated or truncated, Wharf notices, says so in the window, and carries on from the start of the new file.
Sync didn't delete anything
That's deliberate. By default, sync only copies files: a file missing from one side is copied to it rather than deleted from the other. To mirror deletions, tick Also delete files removed on the other side in the sync review sheet. Wharf will then show you exactly which files would be removed before doing anything.
Deletion propagation also needs a previous sync to compare against: on the very first run there is no record of what existed before, so nothing can be identified as deleted.
Does Wharf work with ssh-agent or my ~/.ssh keys?
Not directly. Sandboxed apps cannot reach the ssh-agent socket or read ~/.ssh on a later launch. Instead, use Import Key… when editing a site: the key is copied into your Keychain once, and used from there.
Requirements
macOS 14 or later. Universal binary that runs natively on Apple silicon and Intel.
TOCLOCO LTD, registered in England & Wales (company no. 09950859), 71-75 Shelton St, London, WC2H 9JQ.