Cyberduck Quick Start
- Select a local directory. Determine where on your computer you will be putting the files for your website. All files for a website should be contained within one directory (which may have many subdirectories or levels of subdirectories).
- Know where you will be putting the file on your target webserver (remote/host directory).
For 2.744, all assignments will be going into a directory that has the following format:
The path format will be provided for you with each assignment.
- Know the URL to view the directory on the webserver.
For 2.744, all assignments may be tested by going to the URL that has the following format:
For athena, you create the URL by replacing the
/afs/athena.mit.edu/course/2 in the path with
The standalone FTP client Cyberduck may be downloaded from the Cyberduck home page. It is available for both Windows and Mac operating systems. Run the installer to install the program.
Defining a Bookmark
We recommend creating a bookmark for the 2.744 base assignment directory (the parent directory that holds all of the assignment directories). Then, you can use this bookmark all semester. The 2.744 base assignment directory is at
- From menubar, select Bookmark-->New Bookmark
- Configure the bookmark as follows:
- In the top combo box, be sure that SFTP (SSH File Transfer Protocol) is selected (should be the default).
- For Nickname: enter a name that will help you remember what the bookmark is for. For example,
- For Server: enter
- For Username: enter your athena username.
- For Path: enter the 2.744 base assignment directory (specified above)
- (Optional) For Download Folder: pick a folder on your computer that you want files to be downloaded to, when you double-click on the file. Normally, you would drag and drop from Cyberduck to the folder on your computer that you want the file transferred to.
Your completed dialog should look something like the following:
Close the dialog to create the bookmark (e.g., click the "x" in the top left corner on a Mac or the top right corner on a Windows PC).
- Cyberduck comes preconfigured with a number of bookmarks. Your new bookmark will appear at the end of the list of bookmarks.
- (Optional) You may want to drag your 2.744 bookmark to the top of the bookmark list for easier access.
Using the bookmark
- Double-click on your 2.744 bookmark to start the connection to athena.
- A dialog will display, asking for your password. Type in your athena password and click Login
- Cyberduck will display the folders in the 2.744 base assignment directory. It includes a folder for each assignment that you will be turning in over the semester, as well as a test directory that you may use to practice uploading materials (do not keep anything valuable here, as it may be cleared periodically). A file information combo box (pointed out below) tells you which folder is currently being displayed.
- Click on the triangle to the left of an assignment folder to expand the folder. Search for your username or team mailing list name (depends on the assignment).
- Once you have found your assignment directory, you can navigate to it by double-clicking on it. Cyberduck will then show you the contents of that directory. Your assignment directories start out with no files in them.
- To transfer files to your 2.744 assignment directory, drag and drop the files from your computer to the folder area in Cyberduck (outlined in red above).
If you are trying to move an updated file to your 2.744 assignment directory (i.e., you have previously put the file on athena), Cyberduck will present a dialog box asking you what you want to do. In general, you will want to overwrite the file on athena.
- Cyberduck shows all file transfers in a Transfers window which will show you the status of the file transfer, including whether it is still in progress, completed successfully, or did not complete successfully.
- To transfer files from your 2.744 assignment directory to your computer, drag and drop the files from the Cyberduck file view to the location on your computer you want the file to be copied to.
- You may navigate to different folders using the Back arrow (pointed out below) or the file information combo box (shown dropped down below).
- To delete a file in your 2.744 file space, right-click on the file/folder name and select Delete from the context menu.