Mount App Help

Mount App mounts remote storage (SFTP · WebDAV · S3 · Google Drive · Dropbox) in macOS Finder just like a local drive. Open and save files normally — Mount App syncs them to the remote in the background.

💡 New here? Start with Quick Start — you can have your NAS showing in Finder in about 3 minutes.

Installation

Install and launch Mount App. A cloud icon ☁️ appears in your menu bar.
Actual mounting requires FUSE-T (NFS-based, no kernel extension, no reboot needed). If it isn't installed, Mount App will prompt you when you first try to mount.

Quick Start

Add a bookmark — Click + Add in the sidebar → choose a type → enter the address and credentials → Save.
(Cloud only) Connect your account — For Google Drive or Dropbox, click Connect Account to log in via your browser.
Mount — Select the bookmark and click Mount. The drive appears in Finder.
Use it — Open and save files in Finder; Mount App syncs them to the remote automatically.

Add a Bookmark

Click + Add in the sidebar, choose a storage type, and fill in the details. Passwords and tokens are stored exclusively in the macOS Keychain — they never leave the app except to authenticate with your chosen remote.

Type	Required information
SFTP	Host, port (default 22), username, password, root path
WebDAV (HTTPS)	Endpoint URL, username, password, root path
Amazon S3	Bucket, region, (optional) endpoint, access key, secret key
Google Drive	Client ID — after adding, click `Connect Account` to complete OAuth login
Dropbox	Client ID — after adding, click `Connect Account` to complete OAuth login

Example — Synology WebDAV: endpoint https://<host>:5006 (or 8006), root path /.

Supported Storage

SFTP, WebDAV (HTTPS), Amazon S3-compatible, Google Drive, and Dropbox. HTTPS backends connect securely via rustls. Unicode folder names (including Korean, Japanese, and other multi-byte characters) are normalized to NFC so they display correctly in Finder.

Mount / Unmount

Select a bookmark and click Mount — the drive appears in Finder. You can also mount, unmount, or Reveal in Finder per bookmark from the menu bar cloud icon.

● Mounted · ○ Connected (not mounted) · ◌ Not connected
To unmount, use the same toggle or eject the disk from Finder.

Sync (Upload)

When you save a file it is written locally right away, then a background write-back worker uploads it to the remote (usually within a few seconds). Transient network errors are retried with exponential back-off; changes made while offline are held safely in a durable queue and uploaded once the connection is restored.

The menu bar header shows a sync status summary. If the server is unreachable the status reads ⏸ Sync Paused and resumes automatically when connectivity returns.

Conflict Resolution

If the same file is changed remotely while you are editing it locally, Mount App detects a conflict. Before overwriting the remote copy it backs up the remote version as <file>.conflict-<timestamp> so neither version is lost.

Keep my changes — Uploads your local version to the remote (the backed-up remote copy is preserved).
Keep remote — Discards your local changes and adopts the remote version.

Conflicts can be reviewed and resolved from the Conflict card in the detail view or from the menu bar.

Menu Bar (Tray)

Click the cloud icon in the menu bar to see: a sync status summary at the top, a submenu per bookmark (mount/unmount · Reveal in Finder), and a footer with Open · Help · Preferences · About · Quit.

Settings & Cache

Click the gear icon (⚙) in the top-right corner to open Settings, where you can adjust the theme (System / Light / Dark), the cache limit (MB), and the metadata freshness interval (seconds). The Cache card in the detail view shows current usage and the hit rate — the key metric for snappy Finder performance.

CLI (mountapp)

Mount App can run headless without the GUI (bookmarks are shared between the two).

mountapp list                 # List bookmarks
mountapp add sftp --name myNAS --host h --user u   # Add (secret via MOUNTAPP_SECRET env var)
mountapp mount myNAS          # Mount (Ctrl+C to unmount)
mountapp status               # Show mount status
mountapp sync myNAS           # Show pending / conflict / failed counts
mountapp retry myNAS          # Retry failed uploads
mountapp unmount myNAS        # Unmount

Troubleshooting

I mounted a bookmark but the drive doesn't appear in Finder: Make sure FUSE-T is installed. The first mount may take a few seconds to establish the connection.
I can't connect to my HTTPS server: Double-check the endpoint URL, port, and certificate. Self-signed certificates are not currently supported — a valid certificate is required.
Files inside a folder are missing, or Unicode folder names disappear: Update to the latest version, which includes improved Unicode normalization.
Uploads seem stuck: Check the menu bar for a ⏸ Paused or Conflict / Failed indicator. Failed items can be retried from Settings or via the CLI (mountapp retry).

Security & Privacy

Passwords and tokens are stored only in the macOS Keychain and are never written to logs. All communication uses the encryption built into each protocol (SFTP / HTTPS). Your file contents travel only between your device and the remote storage you configured.