Cyberduck How-to

by Gand — last modified 2007-06-26 03:04 PM
Contributors: David Kocher

FTP and SFTP Browser

Cyberduck site: here


There are several options:
a) Click the 'New Connection' button in the toolbar or the 'File' Menu. You must have a browser window (-N) open to do this. Fill in the relevant information and/or choose a server from the 'Rendezvous' or 'Bookmarks' drop down menu.
cyberduck-0.jpgb) 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. hc.kcudrebyc.tsoh|divad#hc.kcudrebyc.tsoh|divad. It will use the default protocol defined in the application preferences.
You can however not enter a full qualified URL.
cyberduck-1.jpgc) Use the Bookmark drawer. Select 'Toggle Bookmark Drawer (-B)' from the 'View' menu and double click an entry in the table.

d) Use the bookmark menu. Select a bookmark from the 'Bookmark' menu.

e) Double click a Cyberduck bookmark file in the Finder.

Does Cyberduck support Rendezvous/Zeroconf?
In the 'New Connection' Dialog look at the Rendezvous icon in the top left corner. You will get a list with FTP/SFTP servers supporting Rendezvous on your local network.
You can also see available Rendezvous services in the 'Bookmark' menu.


How do I add a new bookmark?

Select 'Show Bookmark Drawer (-B)' form the 'View' menu. Click the plus button to add the host connected to in this browser window to the Bookmarks. An editor window will open where you can further adjust the bookmark properties (i.e. nickname).

Add bookmark

How do I edit a bookmarks?

Open the Bookmark Drawer and click the 'Edit selected bookmark' button. A small window where you can edit the bookmark's properties will appear.

How do I export a bookmark?

Drag the bookmark from the Bookmark Drawer anywhere to the Finder (e.g. the Desktop). You can double click the document in the Finder to open a new connection to the server specified in the bookmark.

Export bookmark

Can I import a bookmark again?

Just drag the bookmark file from the Finder to the Bookmark drawer.

Reimport bookmark


How can I download a file or folder?

Download file

Select the files to download in the browser window and press the 'Download' toolbar button. Or double click the the file. Or select 'Download' from the 'File' or the Context Menu. And last but not least just drag the file(s) or folder(s) to the desired download location in the Finder. A new transfer window will open and show you the transfer progress.

How do I queue a file to be downloaded later?

Drag the file from the browser to the Transfer Queue (-T) window.

Queue file

How can I upload a file or folder?

Either click the 'Upload' toolbar button and select the files to upload in the file chooser dialog or - much simpler - just drag the files from the Finder into the browser window. You can drag multiple files as well as directories.

Upload file/folder

You can also upload files without first opening a connection to a server by dropping the file(s) onto a bookmark item in the bookmark drawer.

Drop file onto bookmark

How can I configure Cyberduck to apply specific default permissions to files uploaded? (By default, Cyberduck applies the permissions the file has on the local system)

Open a Terminal window (Applications/Utilities/ and type:

defaults write ch.sudo.cyberduck queue.permissions.use Default true

defaults write ch.sudo.cyberduck queue.permissions.default rwx--

If you no longer want to use these settings, type

defaults write ch.sudo.cyberduck queue.permissions.use Default false

How do I download file with HTTP (from a web server)?

Select 'New Download (-D)' from the 'File' Menu. Enter an URL (or drag it e.g. from a web browser) pointing to a file. You can also drag an URL directly to the Transfer Queue to initiate the transfer (e.g. from Safari).

Can I move files on a remote host?

Yes, just drag the items into another folder as you would in the Finder. Currently, you can't move files to parent folders.

Move file


You can edit a file just as a local file by clicking the 'Edit' toolbar button or by choosing 'Open in Editor (-J)' in the 'File' Menu. The file will be downloaded to the user's temporary directory and opened with the preferred editor. (Supported editors include SubEthaEdit, BBEdit, TextWrangler and Text-Edit Plus). Set your preferred editor in the Preferences. The file will be uploaded to the server everytime you choose 'Save' in the Editor application. The file is not changed on the server if you just close the document without saving.

Edit file

How do I change a filename?

Select the file to rename and choose 'Info (-I)' from the 'File' menu or press the 'Get Info' toolbar button. Simply enter the new name in the very top field.

How do I change the permissions on a particular file?

Select the file in the browser and choose 'Info (-I)' from the 'File' menu. You can also select multiple files at once.


What proxy servers does Cyberduck support?

In theory SOCKS 4/5. This feature has not been tested. You can adjust the proxy settings in the System Preferences.


Public-key authentication allows you to connect to a remote server without sending your password over the Internet. Public-key authentication uses two keys, a private key that only you have—it should be kept in a secure place and protected with a password. And the public key, which is placed on the server you wish to gain access to, usually by the system administrator when your account is set up.

How do I configure public key authentication?

1. Run the command 'ssh-keygen' from the Terminal to generate a public/private pair of keys. They will be put in your directory ~/.ssh, though you will probably be asked to approve or change this location.

When you generate the keys you will be asked for a 'passphrase'. If you use a passphrase then you will have to enter it each time you use the keys for authentication. That is, you will have to type in the pass phrase everytime you log in, just as you would with a password.

If you don't enter a passphrase (just press the return key) then you will be allowed to log-in without having to enter a passphrase. This is less secure, but it can be really useful.

jungle:~/.ssh dkocher$ ssh-keygen -t dsa

2. Copy the public key to the remote host you wish to access and add it to the file authorized_keys in your ~/.ssh directory. (If that file does not exist then you should create it.) Anybody listed in the authorized_keys file (via their public key) is allowed to log-in, provided that they can prove that they possess the corresponding private key. Thus if you have the private key in your .ssh directory on your home machine you'll be allowed in.

jungle:~/.ssh dkocher$ ssh hostname &lt; 'cat &gt;&gt; .ssh/authorized_keys'

3. In the Connection Dialog or the Bookmark editor in Cyberduck select 'Use Public Key Authentication' and select the private key in your .ssh directory.

• Cyberduck FAQ

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.

Who has written this piece of software?

Cyberduck has been written and is maintained by //David Kocher <>//. It does include third party software. Many have contributed localizations. Please see the credits.

Why isn't there a <insert your preferred language here> localization?

Because nobody has written one yet. Why not doing it yourself? It's easy and you don't need any programming skills. Contact me and I'll send you the relevant files. Current available localizations are English, Dutch, German, French, Italian, Japanese, Korean, Chinese (Traditional and Simplified), Portuguese, Spanish, Finnish, Slovak and Czech.

How do I submit a bug report?

Write an email to //<>// with a description what you have a done and what went wrong. It would help if you can include the crash report and also all the files with the pattern ~/Library/Logs/JavaNativeCrash_pid().log

Where does Cyberduck store its preferences?

~/Library/Application Support/Cyberduck

Known Problems

The server does only allow one single connection; I can't download any files

Close the connection in the browser first using the 'Disconnect' toolbar item. Then double click the file to download.

I try to open a new SSH connection but I just get the spinning progress bar.
In the I can read 'java.lang.NegativeArraySizeException at'

Delete all SSH1 keys in ~/.ssh/known_hosts

When I upload a file I get the error 'SITE chmod 664: command not understood' or 'Permission denied'

Uncheck the option 'Queue > Adjust file permissions on upload' in the Preferences

When listing a directory on a FTP server I get the error message in response to the 'LIST -a' command: 550 Directory not found.

Uncheck the option 'FTP > Send LIST -a command' in the Preferences

In the dialog asking to allow the host key I cannot choose to always remember the host key.
The host key isn't written in the ~/.ssh/known_hosts file

There is either no write permission to the ~/.ssh/known_hosts file or there are incompatible keys stored. Delete the file or remove any SSH1 keys and try again.

If you know of any other problems, please report them to


Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License