Mounting a Hetzner Storage Box in the Finder without installing FUSE
HetznerMount mounts Hetzner Storage Boxes in the Finder through the macOS FileProvider framework, without FUSE. How to set up a box and the five places where you should be careful in version 0.0.5.
A Hetzner Storage Box is cheap storage on the network, but on the Mac you do not get at the files just like that. Either you open an SFTP program every time, or you install macFUSE including its kernel extension to mount the box as a drive.
HetznerMount is my small menu bar app for exactly this case. It mounts one or more Storage Boxes in the Finder, through the macOS FileProvider framework, which iCloud Drive and Dropbox use as well. The box then shows up in the sidebar under "Locations", without FUSE and without a network drive. That works well, but in the current version 0.0.5 it has a few limits you should know before you move important data through it.
Installing
You need macOS 14 (Sonoma) or newer. You download the app as HetznerMount.dmg from the release page on GitHub and drag it into the Applications folder.
The app is not notarized by Apple. A double-click on first launch is therefore blocked by Gatekeeper. Open it once via right-click and "Open", after that it starts normally. The app reports new versions itself, and there is "Check for Updates…" in the menu for that.
Setting up a box
SSH access has to be switched on for the Storage Box, which you set at Hetzner in the box's administration. In HetznerMount you then create the box in the settings:
- Under "Username" you enter your Storage Box user, for example
u123456. From that, the app automatically completes the host tou123456.your-storagebox.de. - The port is set to 23. On this port Hetzner offers the extended SSH service, which SFTP also runs over.
- "Base Path" is the directory that appears as the top level in the Finder. The default is
/, and in version 0.0.5 you should stick with that. Going by the code, the app only maps entries cleanly to the top level in the Finder with/. With a different path, the location presumably stays empty or shows errors. - The password ends up in the macOS keychain, not in a configuration file.
With "Test Connection" the app logs in and reads the Base Path once. Only when that works is mounting worth it. If something goes wrong, the app translates the SSH errors into understandable messages, for example whether the username is wrong or the host was not found.
Every box becomes its own location in the Finder. Through the menu bar icon you mount and unmount them individually, open them in the Finder or have the contents reloaded. With "Launch at Login" the app starts automatically after login.
How the files get into the Finder
At first the Finder only shows the list of files. The app only loads the contents of a file when you open it. When you save a file, the app uploads it to the box again. You can have downloaded files removed again like with iCloud, then only the entry in the Finder remains.
Under the hood everything runs over SFTP with Citadel, an SSH library in pure Swift. If the connection drops, the app rebuilds it on the next access and tries up to three times.
Five places where you should be careful
The server is not verified
When connecting, the app does not check the server's host key, it accepts any. Normally an SSH client remembers the server's key the first time and warns when it changes later. That warning is missing here. On someone else's Wi-Fi, somebody could therefore pose as your Storage Box and grab the password. Until this check is built in, it is best to use the app only on networks you trust.
Password only, no SSH key yet
The settings already have the "SSH Key" choice. But the app itself shows there that this only comes in a later version, and it always logs in with the password. If you want to use only keys for your box, HetznerMount is not the right thing at the moment.
Large files go entirely through memory
When downloading, the app reads a file completely into memory and only writes it to disk after that. Uploading works the same way. The progress indicator therefore jumps from zero straight to done. For documents and photos that is not a problem. A backup archive of several gigabytes is better pushed directly from the terminal, which also works over port 23:
scp -P 23 backup.tar.gz u123456@u123456.your-storagebox.de:backup.tar.gz
Files deleted from elsewhere stay put
When the app re-reads a folder, it reports new and changed entries to the system, but no deleted ones. If a server script or another machine deletes a file on the box, it can still be shown in the Finder. If you then open it, that fails, because the file no longer exists.
With simultaneous changes, the last one wins
If you save a file that was changed on the box in the meantime, the app overwrites the version on the box without asking. There is no conflict copy like with some sync services. If several people or machines work on the same files, that is a reason to be careful.
What I use it for
For quick access to files that live on the Storage Box anyway, HetznerMount is pleasant: click the box in the Finder, open the file, done. For backups, large archives and folders that several systems write to, I stick with rsync, scp or a backup tool that works directly over SSH. If you notice something or want to get rid of one of the limits above, I am happy about an issue on GitHub.
Common questions
- How do I get a Hetzner Storage Box into the Finder on the Mac without installing macFUSE?
- With HetznerMount. The menu bar app uses the macOS FileProvider framework, and the box shows up in the sidebar under "Locations". You need macOS 14 (Sonoma) or newer, and SSH access has to be switched on for the Storage Box.
- Why does HetznerMount not open on first launch?
- HetznerMount is not notarized by Apple, so Gatekeeper blocks the double-click on first launch. Open the app once via right-click and "Open", after that it starts normally.
- Can I log in to HetznerMount with an SSH key?
- Not yet in version 0.0.5. The "SSH Key" choice already exists in the HetznerMount settings, but the app always logs in with the password. The password ends up in the macOS keychain.
- Is HetznerMount suitable for large files and backups?
- For documents and photos yes, for large archives rather not. HetznerMount reads a file entirely into memory when downloading and uploading. A backup archive of several gigabytes is better pushed to the box with scp over port 23.