Filezilla is a free and open source SFTP client which is built on modern standards. It is available cross-platform (Mac, Windows and Linux) and is actively maintained. As such Research Computing is recommending its use over previous clients, especially as it does not have some of the quirks of clients like Cyberduck or SecureFX. This document will outline setting up a bookmark in Filezilla to connect to the cluster or other RC file resources you have access to.
NOTE: If your SFTP session constantly disconnects after several seconds, see this FAQ entry.
Download and Install
First you will need to download and install the Filezilla client: Filezilla-project.org
(Linux users may be able to install Filezilla using their respective package manager.)
Once installed, launch Filezilla and click the Site Manager icon in the upper left to begin setting up a connection bookmark for future use.
Click New Site to add a new bookmark. Enter the connection details in the General tab.
- Host: enter odyssey.rc.fas.harvard.edu (you can also use login.rc.fas.harvard.edu, they are interchangeable).
- Protocol: select SFTP - SSH File Transfer Protocol
- Login Type: select Interactive (this is crucial, otherwise you will not be prompted for your OpenAuth token)
- User: enter your RC account username
- The password box will not exist in new versions, or be greyed out (with or without dots) in older versions because we're using Interactive login.
- Now click the Advanced tab
In the Advanced tab, select the local (i.e. - on your computer) directory/folder you'd like to start in when connecting. You can type this in or click the Browse button and find the directory you want.
You can leave Default remote directory: blank if you simply wish to connect to your RC account's home directory. Or, if you wish to connect to a specific directory (for instance, your lab's shared storage or a particular folder in your home directory), you can enter this here.
Click the Transfer tab and check the Limit number of simultaneous connections box and set Maximum number of connections to "1". Otherwise you will be prompted for your password and token each time the token expires and for every new simultaneous connection during file transfers.
Click Connect to initiate a connection. If you're just making a bookmark for later, click OK.
The first time you connect you will see a window titled "Unknown host key". Check the "Always trust this host, add this key to the cache" box and click OK. This will store Odyssey's key for future use.
A password prompt box will pop up. Enter your RC account password here.
- Check "Remember password until FileZilla is closed", otherwise it will prompt you periodically and interrupt transfers
- Click OK
Another password box will pop up as. This is for your OpenAuth token.
Enter the code shown in your OpenAuth token window (Or Google Authenticator, if you are using that alternative token generator) and click OK.
You should now be connected to Odyssey and see your local files in the left-hand pane and the remote files in the right-hand pane. You can drag and drop between them or drag and drop to/from file windows on your computer. When done, click the red X icon up top to disconnect.
ADVANCED TOPIC: Filename filtering rules in Filezilla
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. Permissions beyond the scope of this license may be available at Attribution.