Known Issues

Performance Considerations

To reduce the number of requests to the remote server for mounted volumes, we recommend the following settings when running in Online connect mode.

Finder.app

  • Choose View → Hide Preview (⌘⇧P)

  • Disable View → Show View Options → Show icon preview

Temporary Files

When opening files with status Online only or when connected with Online connect mode, it may be required to temporarily cache contents depending on the read pattern of the application opening the file. Data ist stored in the temporary file location of the operating system and allows for faster access when repeatedly reading the file. Temporary files are deleted as soon as the application closes the file after reading, unless the option Enable buffering checked in Preferences → Sync.

Tip

When enabled Preferences → Sync → Enable buffering is enabled:

  • In Online connect mode, buffered content in temporary files is kept until disconnecting the bookmark.

  • In Smart Synchronization connect mode, the buffer contents is moved from the temporary folder to the local cache and the status of the file changes to Up to Date.

Filenames

The following characters should be avoided within file and folder names.

  • : (colon)

  • / (forward slash)

  • \ (backslash)

Known Issues

Download trial failed. Error

This is a known bug appearing from time to time while downloading the trial version of Mountain Duck. Please reach out to the Mountain Duck support to receive a trial license file.

Not a valid registration key Error

This error appears if you try to use a license key for older versions of Mountain Duck for a new major version. Registration keys are valid for the current major version at the time of purchase and for previous versions. To use the latest major version you will have to upgrade your license. Alternatively, install an older version of Mountain Duck from the changelog.

Can only open single PDF in Adobe Acrobat Reader

This is a known bug in Adobe Acrobat Reader when opening documents from a network volume. As a workaround uncheck edit → Preferences… → Security (Enhanced) → Enable Protected Mode at startup.

rsync fails with error

If your server does not accept the creation of . temporary files you might need to add the --inplace when running rsync.

High CPU usage when working with Sublime Text

  • When working with Sublime Text we recommend turning off indexing by adding the following setting to your user preferences in Sublime Text.
    "index_files": false

  • You might want to turn off Git support in Sublime which has caused high CPU usage for some users when scanning .git folders.
    "show_git_status": false

Sharing a mounted drive in local network

It is not possible to share a mounted drive within the local network.

Changes from server not immediately visible

In Smart Synchronization connect mode changes from the server must be synced with cached contents on your computer. The directory listing in Finder.app or File Explorer may become out of date when another application is adding, removing, or modifying files on the server. No push notifications are received for changes on the server. Thus, the following strategies are in place to detect changes to existing and new files as soon as possible:

  • With Preferences → Sync → Index Files enabled, remote directories previously opened are polled for changes and new files.

  • When browsing a directory in Finder.app or Windows Explorer will attempt to sync with contents with the server.

  • You can explicitly request to look for changes on the server in a directory by choosing Reload within the context menu.

New folder not uploaded to remote server

Folders that weren’t renamed after creation don’t get uploaded to the server. Change the folder name to something else than Untitled Folder on macOS or New Folder on Windows, and the folder should be uploaded to the server and be visible on the server.

Cache uses a lot of disk space

Disk space is used on your computer for every cached file marked as Up to Date or In Sync in Smart Synchronization connect mode. Files are cached as soon as accessed (e.g. open in any application or previewing in Finder.app or Windows Explorer) or explicitly with Keep Offline on Local Disk.

The cache size can be limited per bookmark in Preferences → Sync. Also files not accessed within a chosen period of time can be purged. Refer to Cache Limitations.

The cache directory is located in %LocalAppData%\Cyberduck\Cache on Windows or within Application Support folder on macOS by default. You can change the cache location to any writable location. You can clear cached files from the local disk with the Delete on local disk context menu option.

Send Command

Insufficient disk space

If the available disk space on the mounted volume is below 100MB a soft quota notification will be displayed saying Insufficient space. Synchronization is paused when the soft quota is reached.

Soft Quota Insufficient disk space

This quota information is only available for the following protocols:

View files from Synplogy Drive

Synology Drive is not supported natively. You can try to view your Synology Drive files by connecting to your Synology NAS. To do that connect to your Synology NAS using the protocol SFTP, FTP, or WebDAV with the path home/Drive.

Note

This won’t allow you to view and access shared files and folders.

Missing Sync Status Icons

Finder
When you have other applications installed that register a Finder Extension (macOS) for the volume mounted, the status icon may not appear. This has been reported for the following applications:

Please check in System Preferences → Extension → Finder for other applications that may override the badge icons.

Note

If none of those applications are in use, a Finder re-launch can make the badge icons appear again.

Operating System specific Issues

Mount is not Visible within the Media Browser (Adobe Premiere)
Bookmarks mounted by Mountain Duck aren’t visible within the Media Browser of Adobe Premiere. The mount location needs to be changed (e.g. to the desktop) to make the mount visible.

Finder.app Does not Show Files Prefixed with . on Remote Volumes
You can work around this by setting defaults write com.apple.finder AppleShowAllFiles YES in a Terminal.app window and restart Finder.app using → Force Quit … → Finder → Relaunch. If you are running macOS Sierra (10.12) you can choose ⌘⇧. to toggle files starting with a dot to show in Finder.app.

Original Document can’t be Changed (Preview.app)
Files opened in Preview.app and edited cannot be saved at the original location but the message “The original document can’t be changed, so a duplicate with your changes has been created” is displayed in the title bar. As a workaround, you can set a custom mount point in Preferences → Connection → Mount Location for volumes such as a ~/Volumes/ folder in your home directory.

Enable Application Icon in Dock
As a utility application with no application windows, no icon is displayed in the Dock but only in the system status bar. If you want to enable the application icon to appear in the Dock set the following property:

defaults write io.mountainduck application.dock.icon.enable true

Mounted Volumes do not Appear on the Desktop
Navigate to volumes using ⌘⇧C in a Finder.app window or choose Finder → Preferences … → General → Show these items on the desktop: Connected Servers to make the volume appear on the desktop. Mounted volumes are also listed in the Finder.app sidebar in Favorites.

Search in Finder.app (Spotlight)
The Spotlight indexer does not work on remote volumes.

Multiple Mountain Duck Finder Extensions Processes
The system may launch additional copies of Mountain Duck Finder Extension whenever an Open or Save dialog is displayed. This means there may be multiple copies of the extension running at once, and some may be very short-lived.

Connection Interrupted
It may be that Finder closes the connection because Mountain Duck hasn’t answered fast enough on the request of Finder. Although Finder indicates that the server connection is interrupted it isn’t as Mountain Duck is still connected to the server.

This is an issue within the operating system that can occur to any network drive.

Additional ._* Files Saved on Remote Volumes
The ._* files contain metadata about the files some applications write in additional to the file content. On macOS, this metadata can be stored alongside the file on the filesystem, but on remote volumes, with no metadata suppport, an auxiliary file is created to contain this information. You can delete metadata on files using xattr -d <filename>.

As of version 2.1, extended attributes are only saved in a temporary location and not stored on the mounted remote volume. If you want to revert to saving extended attributes to the server, enter in a Terminal.app window:

defaults write io.mountainduck fs.filenames.metadata.enable false

If you want to delete metadata files, you can open a Terminal.app window and enter dot_clean -m <folder>.

Interoperability

Hosting Service Providers

A list of known providers that fail to work with Mountain Duck due to interoperability issues.

  • OwnCube: Their deployment does not work and we discourage this product.

  • Bitnami ownCloud: PHP-FPM is enabled by default in virtual machines and Ubuntu-based cloud images but must be disabled for uploads to complete. Refer to How to disable PHP-FPM and 0 byte files on WebDAV server.

Third-Party Software

Kaspersky Internet Security

Make sure to uninstall Kaspersky Internet Security with its kernel extensions causing kernel panics prior to mounting a volume.

Eset Cyber Security Pro

Make sure not connections on the loopback interface are blocked.

Bitdefender

Be aware that Bitdefender may interfere with connections.

Sophos Endpoint Protection

May interfere with installation.

Backups

Time Machine
Backups to Time Machine do not work with volumes mounted from Mountain Duck. Time Machine requires disks mounted using Apple File Protocol (AFP). See Backup disks you can use with Time Machine.

Bug Reports and Feature Requests

To get help with bugs, feature requests, or other issues please refer to support.