Cyberduck Help / Howto / Opening Connections

Toolbar button

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

Supported protocols

• FTP protocol support
• Amazon S3, Google Storage and Eucalyptus protocol support
• 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.
• Rackspace Cloud Files protocol support
• 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.

Proxy servers

The following proxy settings in System Preferences are supported. Choose Cyberduck → Preferences → Connection → Use system proxy settings. No additional configuration needed.

• SOCKS Proxy for all connections.
• Web Proxy (HTTP) for WebDAV, S3, Rackspace Cloudfiles, Swift OpenStack, Google Storage, Dropbox and Google Docs.
• Secure Web Proxy (HTTPS) for WebDAV, S3, Rackspace Cloudfiles, Swift OpenStack, Google Storage, Dropbox and Google Docs.

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. user@example.net, or a fully qualified URL such as ftp://mirror.switch.ch/mirror/.

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

From bookmarks

Select View → Toggle Bookmarks and double click a bookmark.

If you want to bookmark a connection already open, choose Bookmark → New Bookmark and it will add a new bookmark with the current connection settings.

From the history

Select a bookmark from the menu Bookmark → History.

From Bonjour discovered services

Servers in the local network are most likely to appear in the menu Bookmark → Bonjour.

From the Finder.app

Double click a Cyberduck bookmark file in the Finder.

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

Use an application launcher

• Quickilver. ​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.
• LaunchBar. ​Indexing rule for Cyberduck.

Use Spotlight

Drag URL to 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.