Cyberduck Mountain Duck CLI

Cyberduck Help / FAQ

General

What is Cyberduck?

Cyberduck is an open source FTP/SFTP (SSH Secure File Transfer), WebDAV and Amazon S3 browser licensed under the GPL.

Is Cyberduck free?

Cyberduck is free software. Free software is a matter of the users' freedom to run, copy, distribute, study, change and improve the software. If you find this program useful, please consider making a donation. A donation would not only demonstrate your appreciation of this software, but also help to advance development in the future. You receive a registration key and it will help to make Cyberduck even better!

Mac App Store

The presence of Cyberduck is important for the visibility of the project in particular for new and average users on the Mac platform. The caveat is that the donation key model is not supported in the App Store per the developer agreement. Software asking for voluntary contributions does not get approved. We have therefore opted to distribute Cyberduck in the App Store for a fixed price with no donation prompt. It is your choice to buy the version from the App Store or download from the website and opt in for a payment if you feel like. Cyberduck is libre (FLOSS) software and will remain so in the future.

Your purchase receipt from the App Store version is copied to the Application Support folder and recognized as a key when running any version of Cyberduck.

Windows App Store

The Windows Store does not support the donation key model. We have therefore opted to distribute Cyberduck in the Windows Store for a fixed price with no donation prompt. It is your choice to buy the version from the Windows Store or download from the website and opt in for a payment if you feel like. Cyberduck is libre (FLOSS) software and will remain so in the future.

Troubleshooting

If you bought Cyberduck on Windows Store, but you are not allowed to use Cyberduck due to a Trial Expired error message, please execute the following steps to ensure that your local app license cache is up-to-date – a reinstall of Cyberduck via Windows Store does not refresh your license.

  • Press the Windows Key + R which opens the “Run” function.
  • Type in “WSReset” and press enter
  • Open the Windows Store
  • Select the user icon (top right)
  • Select the very top option (where the user profile picture is listed)
  • Select the account
  • Select Sign Out
  • Select the user icon (top right)
  • Select Sign In

If these steps are not resolving the trial expired message please follow these additional steps to ensure all packages are registered correctly.

  • Open Start, type PowerShell and open it as Administrator (Ctrl+Shift+Enter, Right-click "Run as Administrator")
  • Copy Get-AppXPackage -AllUsers | Foreach {Add-AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"}
  • Paste it into the window
  • Run it and wait for completion.

Registration Keys

As a contributor to Cyberduck, you receive a registration key that disables the donation prompt that is displayed after installing or updating Cyberduck. Support for registration keys is available in Cyberduck 3.2 or later.

Recover a Registration Key

Registration keys can be recovered using the email address you registered with Paypal.

No registration key received

  • A key is sent when the the payment is no more pending.
  • Verify that your email address registered with Paypal is still valid.
  • Check the spam folder of your email application.

The registration key received cannot be opened

The registration key is sent to you by email automatically after the the Paypal transaction has been completed. Make sure the filename of the registration key ends with .cyberducklicense. Some email applications change the extension to .xml when saving the attachment. If the key is invalid, the file must have been modified when saving it from your email application. Try the following:

  • If you are using a webmail provider, try using a different browser or email client application to access your mail. 
  • Contact your hosting service provider how to download attachments.
  • Forward the mail to a different mail account where you possibly don't have an issue downloading attachments.

System requirements

macOS

  • Cyberduck 4.7 or later requires Mac OS X 10.7 or later and a 64bit 64Bit Intel architecture.
  • Cyberduck 4.4 or later requires Mac OS X 10.6 or later and a 64bit 64Bit Intel architecture.
  • Cyberduck 3.3 or later requires Mac OS X 10.5 or later.
  • Cyberduck 3.0 or later requires Mac OS X 10.4 or later. The latest version available is 3.2.1 supporting Mac OS X 10.4.
  • Cyberduck 2.5 or later requires Mac OS X 10.3.9 or later. The latest version available is 2.8.5 supporting Mac OS X 10.3.9.
  • Cyberduck 2.3 or later requires Mac OS X 10.2 or later. The latest version available is 2.3.3 supporting Mac OS X 10.2.

Windows

Requires at least Windows Vista (32bit/64bit) with .NET Framework 4.5.x. If the .NET Framework installation fails, download it manually from

Installation

Windows

EXE Installer

Run the Cyberduck Installer executable. For an unattended installation, use the silent option (command line option /s).

MSI Installer

Download MSI Installer for corporate environments. Requires prior installation of Microsoft .NET Framework 4.5.1.

Chocolatey

There is also a Chocolatey package maintained.

Mac

Move the unzipped application bundle Cyberduck.app from the Downloads to the /Applications folder on your harddisk.

Preferences and application support files location

macOS

Preferences are saved in ~/Library/Preferences/ch.sudo.cyberduck.plist. Bookmarks, history and connection profiles are saved in the application support directory. These settings are shared with Cyberduck CLI and Mountain Duck.

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

Navigate to the Library folder using ⌘⇧-L or use Go → Go to Folder… in Finder.

Windows

Bookmarks, history, profiles and workspace information is saved in the application data directory. Preferences are stored relative to the Roaming folder above in \iterate_GmbH\Cyberduck.exe_Url_[id]\[version]\user.config. You can navigate to the AppData folder by opening a File Explorer window and paste %APPDATA%/iterate_GmbH in the Quick access location field.

  • %APPDATA%\Cyberduck

Please note that settings in %APPDATA%/Cyberduck/default.properties takes precedence over user.config.

Bug Reports and Feature Requests

Submit a bug report or request a feature

Open a new ticket using the issue tracker with a description of what you have a done and what went wrong or describing the missing functionality in detail. Make sure to look or search for existing tickets first.

  • Make sure to include any related output in the system.log (/Applications/Utilities/Console.app) on a Mac.
  • Include the logging information found in the cyberduck.log file in the AppData directory.
  • Always include the full transcript from View → Toggle Log Drawer from both the “Browser” and the “Transfers” window.

Enable debug logging

macOS

Open a Terminal.app window and enter

defaults write ~/Library/Preferences/ch.sudo.cyberduck.plist logging debug

Restart Cyberduck and look for output in the system.log in Console.app (In /Applications/Utilities).

Reset the logging configuration with

defaults delete ~/Library/Preferences/ch.sudo.cyberduck.plist logging

Crash reports are saved to ~/Library/Logs/DiagnosticReports/Cyberduck_*.crash.

Windows

Logging information can be found in the cyberduck.log file in the AppData directory. Crash reports are saved to the same directory in a folder named CrashReporter. Run the command %APPDATA%\cyberduck by pressing the Start button and the choose Run.... After choosing OK an Explorer window should open showing the Cyberduck settings folder. From there you can navigate to the CrashReporter folder.

Debug logging can be enabled with a hidden setting. As there is no user interface for this yet you need to add the setting manually. If not existing yet you have to create the file AppData\Cyberduck\default.properties and then add the property as follows:

...
logging=debug
...

Cyberduck CLI

Set the environment variable logging to the level debug, info, warn or error.

Snapshot and Beta builds

See Preferences → Update.

Incompatibilities

  • WindowDragon. Cyberduck is not compatible with WindowDragon.
  • Sophos Anti-Virus On-access Scanning (see #5971).
  • Make sure no libraries (*.jar dependencies) are installed in /Library/Java/Extensions or ~/Library/Java/Extensions respectively that take precedence in the Java classpath, in particular Bouncycastle (bcprov-*). Installing such libraries per system or user is discouraged as it will ultimately lead to versioning conflicts sooner or later.
Last modified 9 months ago Last modified on Feb 9, 2018 12:49:51 PM

Attachments (3)

Download all attachments as: .zip

swiss made software