Mountain Duck for Mac: A Detailed User Guide

Mountain Duck is a professional macOS application that allows users to mount cloud storage services (such as Amazon S3, Backblaze B2, Google Cloud Storage, Microsoft Azure, SFTP, WebDAV, etc.) as well as FTP/SFTP servers as local disks. This means you can browse, edit, and manage remote files directly in Finder just like local folders, greatly simplifying the workflow for cloud files.

1. Core Interface and Workspace Overview

Mountain Duck adopts a clean background service with deep system integration, and its core interactions are mainly accessed through the menu bar icon, the System Preferences pane, and Finder.

1.1 Menu Bar Icon

After launching Mountain Duck, a duck icon will reside in the menu bar at the top right of the screen. Clicking this icon opens the control center.

• Mounted Volumes: Lists all currently mounted remote connections; click to quickly open them in Finder.
• Connections: Displays all saved bookmark configurations for quick mounting or editing.
• Transfers: Shows the current queue, progress, and speed of file uploads/downloads.
• Recent: Quickly access recently opened remote files and folders.
• Preferences…: Opens the application’s main settings pane.
• Quit: Quit Mountain Duck; all mounted volumes will be unmounted.

1.2 Preferences Panel

This is the core configuration area of the software, which can be opened via the menu bar icon or the launchpad.

• Bookmarks Tab: Manage all server connection configurations. The list displays saved bookmarks, and you can add, edit, duplicate, and delete them. Each bookmark contains detailed configuration such as protocol, server address, and authentication information.
• General Tab: Set startup behavior, cache location, file synchronization options (such as cache retention time), and more.
• Transfers Tab: Configure advanced transfer settings such as the number of concurrent connections, bandwidth limits, and temporary file handling.
• Advanced Tab: Set file encoding, proxy, custom CA certificates, and more.

1.3 Finder Workspace

After a successful mount, the remote server will appear as a separate disk volume in the Finder’s “Locations” sidebar and on the desktop. File and folder operations within it are the same as with a local disk, but note that files are actually transferred over the network in a streaming manner.

II. Complete Workflow: From Connection to Export

2.1 Create and Save a New Server Connection (Bookmark)

1. Click the Mountain Duck icon in the menu bar and select “Preferences…”.
2. In the Preferences window that opens, make sure you are on the “Bookmarks” tab.
3. Click the “+” button in the bottom-left corner.
4. In the dialog that appears, select a connection protocol from the drop-down menu at the top (such as SFTP, WebDAV, Amazon S3, etc.).
5. Depending on the selected protocol, fill in the server address (URL or hostname), port, and path.
6. In the authentication section, enter your username and password (or use a private key, Access Key/Secret Key, etc.).
7. You can set an easily recognizable nickname for the connection.
8. Click the “Add” button to save this bookmark.

2.2 Mounting a Remote Server

After saving a bookmark, there are several ways to mount it:

1. Method 1 (via the menu bar): Click the menu bar icon, find the bookmark you just created in the “Connections” list, and click it to mount.
2. Method 2 (via Preferences): On the Bookmarks tab in Preferences, select the bookmark and click the “Connect” button in the bottom-right corner.
3. Method 3 (keyboard shortcut): If you have assigned a keyboard shortcut to the bookmark, you can press it directly to mount.

Once mounted successfully, a disk icon named after the bookmark’s nickname will appear on the desktop and in the Finder sidebar.

2.3 Working with Remote Files in Finder

Just like using a local disk:

• Browse: Double-click to open the folder.
• Open/Edit Files: Double-click a file, and the system will open it with the associated local application. Mountain Duck will automatically download the file to the cache in the background, and automatically upload it when you save after editing.
• Upload Files: Drag local files or folders into the target folder in the mounted volume.
• Download Files: Drag files from the mounted volume to a local folder.
• Create/Delete/Rename: Right-click within the mounted volume and select “New Folder”, or perform delete and rename operations; changes will sync to the remote server in real time.

2.4 Monitor and Manage Transfer Tasks

Click the menu bar icon and select “Transfers” to view all in-progress, queued, completed, or failed transfer tasks. You can pause, resume, or cancel specific tasks.

2.5 Unmount (Disconnect) and Quit

• Unmount a single volume: In Finder, drag the mounted disk icon to the Trash; or right-click the disk icon and select “Eject”.
• Unmount via the menu bar: Click the menu bar icon, find the volume you want to unmount in the “Volumes” list, and click the pop-up icon on the right.
• Quit the software completely: Click the menu bar icon and select “Quit”. All mounted volumes will be unmounted before quitting.

III. Advanced Tips for Common Features

3.1 Use Encrypted Bookmarks

When creating a bookmark, you can enable the “Cryptomator” or “Encrypt” option (depending on protocol support) to create a locally encrypted vault for remote storage. All files will be encrypted locally before upload, ensuring cloud data privacy.

3.2 Set Shortcuts for Frequently Used Bookmarks

In the Bookmarks tab of Preferences, double-click a bookmark to edit it. At the bottom of the window, you can assign a global shortcut to it (e.g., ⌃⌥⌘S). After that, you can quickly mount or unmount it by pressing the shortcut without opening any interface.

3.3 Use the “Synchronize” Feature for Offline Access

For folders that need to be available offline, you can synchronize them locally:

1. In the mounted volume, right-click the folder you need offline.
2. Select “Synchronize to Local Folder…”.
3. Choose a local destination folder, and Mountain Duck will begin downloading all contents of that folder.
4. Afterward, even if the connection is disconnected, you can synchronize changes via “Synchronize Now” or “Synchronize with Remote” in the right-click menu.

3.4 Adjust Cache Policy to Save Space

In the “General” tab of Preferences, you can set the cache cleanup policy. For example, set “Keep cache for” to a shorter duration (such as 1 day), and the software will automatically clean up expired cache files that have not been accessed, freeing up disk space.

IV. Common Issues and Solutions

4.1 Mounting fails with “Connection refused” or “Authentication failed”

• Check the network: Make sure the network is working properly and the target server is reachable.
• Verify the parameters: Carefully check whether the server address, port, path, username, and password (or key) in the bookmark are correct. Pay special attention to case sensitivity and special characters.
• Verify the protocol: Confirm that the protocol supported by the server (SFTP vs FTP) matches the bookmark settings.
• Check permissions: Confirm that the logged-in user has permission to access the target path.

4.2 File operations (upload/delete) are slow or stall

• Check network speed and latency: The geographic location and network quality of the remote server directly affect speed.
• Adjust the number of concurrent connections: In the “Transfers” tab of the preferences, appropriately increase the “Concurrent transfers” value, which may improve the efficiency of small file transfers.
• Check the transfer queue: There may be many files queued. Manage the queue through the transfers panel in the menu bar.

4.3 After editing a file, changes are not automatically saved to the server

• Confirm the connection status: A network interruption may cause the upload to fail. Check the menu bar icon to confirm that the volume is still mounted.
• Manually trigger save: Try copying the file in Finder, or restart the associated application and save again.
• Check the cache: In the “General” tab of Preferences, click “Open Cache Folder”, locate the cached version of the corresponding file, and check its modification time.

4.4 The disk volume cannot be “ejected” properly

• Close programs using the files: Make sure all files opened from that volume (such as documents and images) have been closed.
• Force eject: In the “Volumes” list in the menu bar icon, hold down the ⌥ Option key. The eject icon on the right will change to a force eject icon; click it.
• Restart the software: Quit Mountain Duck from the menu bar, then launch it again.

5. Mountain Duck for Mac Keyboard Shortcuts Summary