Installation

Download and Install

Move the unzipped application bundle Mountain Duck.app from the Downloads to the ~/Applications or /Applications folder on your computer.

Note

No admin privileges for installation are required.

Tip

Mountain Duck is available in the Mac App Store.

Extensions

Enabling the Mountain Duck Finder Extension is required for Context menu items and sync status as Badges on file icons in Finder.app for Smart Synchronization and Online connect mode:

  1. Enable Mountain Duck in System Settings → General → Login Items & Extensions → Allow in the Background

    System Settings
  2. Enable Mountain Duck Helper in System Settings → General → Login Items & Extensions → File Providers

    System Settings

Tip

Technically the extension is a Finder Sync extension inside Mountain Duck Helper albeit listed in the File Providers category.

System Requirements

  • Mountain Duck 5.0.0 or later requires macOS 13 or later

  • Mountain Duck 4.14 or later requires macOS 10.13 or later

  • Mountain Duck 3.3.5 or later requires macOS 10.12 or later

  • Mountain Duck 3.0.1 or later requires macOS 10.11 or later

Registration Key

Double-click the file .mountainducklicense to apply the license and register Mountain Duck. Alternatively, you can copy the key file to the application support folder.

You can manually install the registration key in

  • ~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/

Known Issues

Not a Valid Registration Key

This error message appears if you try to use an old license key for a newer version. Upgrade your license to the latest version of Mountain Duck or download an older version from Mountain Duck changelog.

Windows Installation

Optional Driver Installation

Connecting using Online or Smart Synchronization connect mode requires the installation of an additional file system driver in Windows. The following prompt is displayed when attempting to connect the first time.

CBFS Driver Installation

Tip

The installation of the file system driver is not required for Integrated connect mode.

Error Code 0x24C

If you get the error code 0x24C uninstall the client, reboot the system, and reinstall the client.

0x24C. A volume has been accessed for which a file system driver is required that has not yet been loaded.

Troubleshooting

For troubleshooting purposes when reaching out for support, please share the latest installation log. The installation log file prefixed Mountain Duck_ can be found in %Temp%.

Installation with Device Management Software

You can distribute Mountain Duck with the help of Active Directory or a system management tool like Intune on Windows or JAMF on macOS and copy the license file into the application support folder after installing Mountain Duck. Installation packages are provided in MSI (Windows) and PKG (macOS) formats.

Defaults

  • Add preconfigured connection profiles and bookmarks this way by copying the connection profile file (.cyberduckprofile) into the Profiles folder or the bookmark file (.duck) into the Bookmarks folder within the application support folder.

  • Share default settings by using the default.properties file.

Uninstall application and application data

Follow the steps below to uninstall Mountain Duck completely.

  1. Close the application and navigate to the application folder using the shortcut ⌘⇧A. Select Mountain Duck.app and delete the application by choosing File → Move to Trash.

  2. Navigate to the Group Containers folder within ~/Library/ and delete the folder G69SCX94XU.duck. If you changed the cache location you will have to delete that folder as well.

  3. Run the Terminal.app command to reset and erase the settings for Mountain Duck: defaults delete io.mountainduck

  4. Optional: Delete all saved login credentials regarding Mountain Duck within Keychain Access.app.