Cyberduck Mountain Duck CLI

Version 56 (modified by dkocher, on Sep 21, 2011 at 2:37:50 PM) (diff)


Cyberduck Help / Howto / Opening Connections

Supported protocols

A plethora of protocols is supported to connect to just about any server you want.

FTP protocol support

With support for secure TLS connections

Amazon S3 protocol support

Supported service providers:

WebDAV protocol support

Connect to any WebDAV compliant server using both HTTP and HTTP/SSL.

SSH/SFTP protocol support

Advanced configuration for SSH connections using public key authentication.

OpenStack Object Storage protocol support

Supported service providers:

Windows Azure protocol support

Google Docs protocol support

Access all your documents and upload files of any type to use your Google Docs account for storage.

Dropbox protocol support

Access your Dropbox without syncing to your computer.

Toolbar button

Click the New Connection toolbar button or File → Open Connection... (⌘-O). If you want to open a connection in a new browser window, choose File → New Browser (⌘-N) first.

Quick Connect

Type in the name of the server directly in to the Quick Connect field in the toolbar. The text field will autocomplete from bookmarked hosts. You can enter a string in the format user@host, i.e., or a fully qualified URL such as

If you enter just the hostname, the default protocol as configured in Preferences → General → Connection will be used.


Select View → Toggle Bookmarks (⌘-B) and double click a bookmark to connect. If you want to bookmark a connection already open, choose Bookmark → New Bookmark (⌘-⇧-B) and it will add a new bookmark with the current connection settings.

Additionally you can switch to the History or Bonjour in the bookmark view.


List all recently connected servers. Select a bookmark from the menu Bookmark → History or the History tab of the bookmark view.

Bonjour discovered services

Auto discovery of FTP & WebDAV services in the local network. Servers appear in both the menu Bookmark → Bonjour and the Bonjour tab of the bookmark view.

Opening connections from

Bookmark File

Double click a Cyberduck .duck bookmark file in the Finder.

Internet Location File

Double click a Internet Location File in the Cyberduck must be configured as the default protocol handler for the given protocol of the URL.

Use Spotlight

Application launchers


Quicksilver is a launcher application. Open the Quicksilver Preferences and install the Cyberduck Module. Then when Cyberduck is selected in Quicksilver use the right-arrow key to access bookmarks wthin Quicksilver.


Indexing rule for Cyberduck.

From thirdparty application

Drag an URL from any thirdparty application to a browser window.

  • Drag an URL (e.g. from Safari) to the browser list or outline view to open a new connection.
  • Drag an URL to the bookmarks to create a new bookmark.

Problems Connecting

I get an error IO Error: Broken pipe

There was a problem with the unerlying network stream either because the connection was too slow or the server wouldn't give a response anymore. Often this is caused when you run out of quota on the server - meaning that your user account is not allowed to use any more harddisk space.

I get an error IO Error: Read Timed Out

When attempting to open a connection, there is either a firewall blocking requests, or no server is listening at the given address and port. If you get this error while already connected to the server, the network connection to the server is too slow or has a too high latency. You can try to increase the connection timout in Preferences → Connection → Timeouts.


Useful to look at issues is the transcript written to the log drawer. Choose View → Toggle Log Drawer. All commands written to and read from the server are logged there if the drawer is open.

No transcript is written for SFTP connections. Issue #2944.

Proxy Configuration

The following proxies are supported:


The following proxy settings in System Preferences → Network are supported:

  • The option Exclude simple hostnames is respected and applies to all hostnames not fully qualified.
  • The hostnames and wildcards in Bypass proxy settings are applied.
  • CIDR notations are parsed and matched against the IPv4 address of the hostname.

The Automatic Proxy Configuration using a Proxy Configuration File is currently ignored.


All proxy settings are supported.


Connection → Text Encoding

The text encoding selected is used to decode the filenames in a directory listing sent by the server. It is important this matches the text encoding used by the server to encode the characters as otherwise characters not in the ASCII range (such as German Umlaute) are not displayed correctly. UTF-8 (the default), ISO-8859-1 and Windows-1252 are the most common. You can also change the text encoding per browser using View → Text Encoding.

Connection → Timeouts

You might need to adjust the timeout to wait for an answer from the server. The default is set to 30 seconds.

Connection → Repeat failed networking tasks

Failed transfers due to network connection issues such as a low latency can be choosen to be repeated with a configurable number of retries.

Connection → Proxies

Choose Cyberduck → Preferences → Connection → Use system proxy settings. No additional configuration needed.

General → Connection → Use Keychain

Search for and save passwords in keychains (Manage your passwords with Keychain on Mac). On Windows, passwords are encrypted using your login credentials and stored in the user.config file.

Prefer IPv6 adresses of DNS lookups

A hidden configuration option. Refer to #2539.

defaults write ch.sudo.cyberduck connection.dns.ipv6 true

Disable Bonjour support

A hidden configuration option.

defaults write ch.sudo.cyberduck rendezvous.enable false

Add to Keychain unchecked by default in login prompt

Do not add password to Keychain upon successful login.

defaults write ch.sudo.cyberduck connection.login.addKeychain false

Default protocol handler

You can set Cyberduck or a third party application as the default application (protocol handler) for FTP and SFTP in Preferences → FTP and Preferences → SFTP respectively. When you click URLs in another application like your web browser, this application is opened to open the URL instead.

No image "Default FTP Protocol Hanlder.png" attached to help/en/howto/connection

Connection Profiles

Connection profiles are documents describing specific connection settings for a hosting provider. These files can be created on demand for a customer to make it easier to connect with a double click on that file without entering the connection details manually. Contact us if you are a service provider and need assistance in setting this up.

Attachments (7)

Download all attachments as: .zip