Using Cyberduck with Yoda

Cyberduck is desktop software for Microsoft Windows 10 and Apple OSX that can be used to transfer files between your computer and Yoda. In this guide we will explain how to install Cyberduck, create a new connection (bookmark) to Yoda and end with some frequently asked questions and tips on using Cyberduck.

Getting Cyberduck

If you're working on your personal device, simply download Cyberduck from https://cyberduck.io/download/. It's completely free, and no registration is required.

Note: For users that work with a EUR-Laptop we advise to use WinSCP. WinSCP can be downloaded from the EUR software center.

Cyberduck website

Run the downloaded installer by double clicking on “Cyberduck-installer.exe” which you will find in your Download folder in explorer. Install Cyberduck with the default options, and once that is done launch Cyberduck from the start menu.

Cyberduck launch using start menu

Configuring Cyberduck

Create a new secure WebDAV (HTTPS) connection to Yoda (bookmark)

First create a new bookmark by pressing the + button on the lower left side of the screen.

Cyberduck main window

You will now see a new connection page:

Configuring a connection in Cyberduck

Click on the “FTP (File Transfer Protocol)” dropdown list and select a WebDAV (HTTPS) connection.

Cyberduck drop down menu connections

Fill in the following information in the appropriate fields

First generate a Data Access Password:

  • Server: erasmus-data.irods.surfsara.nl
  • Username: your email address
  • Password: paste (CTRL-v) the data access password you created in the portal.

Cyberduck uses your home folder as a default directory to download files. This can be changed by clicking on “More Options” and choosing a new folder.

Cyberduck editing window created bookmark

You have successfully created a bookmark, close the editing window by clicking on the X button on the top right of the edit window to return to the main Cyberduck screen.

Connecting to Yoda

The main screen shows all the connections (bookmarks) you have defined. To connect, double click on the bookmark (in this case “erasmus-data.irods.surfsara.nl - WebDAV (HTTPS)”) and you will be connected.

Connecting to Yoda with Cyberduck

If your login unexpectedly fails, please check if your data access password is still valid.

You should now see your project directory in an explorer like window:

Project directory Yoda in Cyberduck

Working with YODA folders and uploading/ downloading files

Click on a > to open a folder,

Open folder Yoda with Cyberduck

Use the left, right and up arrows to navigate the directory tree and right click on the main window to create a new folder:

Create new folder Yoda with Cyberduck

Alternatively, drag-and-drop folders and files from Windows Explorer to your Yoda project folders:

Drag and drop folders and files from Windows Explorer to Yoda

In either case, once copying has started you should see the transfer window. Keep this open until the transfer is complete.

Transfering files to Yoda with Cyberduck

Alternatively, the context menu (activate by right clicking on a Yoda project file/directory) has a number of options for uploading, downloading and synchronizing files and folders:

Cyberduck context menu with several options

Some things to consider when using Cyberduck/ WebDAV

Total path and file length

When using Cyberduck you need to make sure that your path lengths (directories + filename) are less than 255 characters long. When using WebDAV this is also true on the server side (Yoda) this includes server name, project name and project folders. Be careful when copying deep directory structures and very long filenames to Yoda using Cyberduck and WebDAV. Fortunately, Cyberduck will display an error message and not copy the file when either trying to copy a file with a too long source or destination path. This error is typically “access denied” (403 or 500) error and if you click “continue” Cyberduck simply skips that file, and it is not transferred to Yoda.

Recommendation. If you get “access denied errors” when transferring files with Cyberduck

  • Make a note of which files fail to copy.
  • Flatten the directory structure or shorten the filename.
  • Zip the “main” directory branch(es) that contain the long path names into individual ZIP archives.

Frequently asked questions

Q1) When I try to delete a file, I get a “cannot delete <filename>” Cyberduck error.

Cyberduck delete file error message

This error message can appear when the file/folder is read-only. Read only access can be a result of:

  • The folder has been locked.
  • You have been given read-only access to the project folder

Answer: unlock the folder in the research portal or get project read/write access.

Q2) I copy a file using Cyberduck, the transfer succeeds but I don’t see the file in the portal.

The folder you are copying to is marked as read only. Read only access can be a result of:

  • The folder has been locked in the YODAportal
  • You have been given read-only access to the project folder

Answer: unlock the folder in the research portal or get project read/write access.

Q3) I tried to delete a file but get an “Access denied” error message

One possibility is that the file has been corrupted during upload and is incorrectly registered in the iRODS database.

Answer: Contact your data manager or iRODS administrator to fix the problem. Set Cyberduck to use single connection WebDAV copying

Setting Cyberduck to single connection

This page was last updated in April 2024. Did you find a broken link or (seemingly) incorrect information? Please send an email with the title 'Website content' to datasteward@eur.nl.

Compare @count study programme

  • @title

    • Duration: @duration
Compare study programmes