How to use FTP

Regardless of whether you have an account with Figshare authentication (either an individual account or institutional) or you use an institutional account with SSO, you can upload files in the account by using the new FTP uploader.

The method allows you to easily and securely upload files in your account directly from your computer by using a secure FTP connection. To use this method, you will need to install an FTP client like Filezilla (but any FTP client will work).

There are several details you need in order to connect to the Figshare FTP server to be able to upload data to your account.

Host: ftps.figshare.com

Transfer mode: This should be set to passive. This is the default mode for some FTP clients, however please make sure you are using this mode.

Username: You can find the username in the Application page of your account, which is accessible via the user menu.

Password: Depending on the authentication method for your account, you will either be using the same password as the one used to log in to Figshare or you will be able to generate one if your account has SSO.

If you generate a password, you need to store it safely as it will not be displayed in the interface. However, if you forget it you’ll always be able to generate a new one. In this case, the old password becomes unusable.

 

 
After you have all the above information, connect to the FTP and by default we will create a folder called “data” upon your first log in. The data folder is your home directory.

 

To upload your file(s) you need to create a folder first within the data directory. Each item needs its own folder. The folder name will become the item title. For example, if you have several files and you want to upload them into separate items — and get a DOI for each of them — you will need to make multiple folders. If you want to group the files together, create a single folder and upload them all inside.

 

After you create the folder, navigate inside it and upload the file(s). The files will be processed immediately. After successfully processing the file(s), they are deleted from the folder and a log event is inserted into processed_files_log.txt, which is created on the fly. The log file is located in the item folder. Another log file is created debug_log.txt containing all actions for items/files.

 

There are some simple rules you need to follow when creating a folder:

    • The folder name has a maximum of 200 characters. After you finish uploading, you can modify the item title from My data in the Figshare interface. After you rename the item title, you will still be able to upload files in the folder, even if it has a different name.
    • There are some characters that you cannot use, as they are not allowed by operating systems: \ / : * ? " < > | ' { }
    • You cannot upload a file called debug_log.txt or processed_files_log.txt.
    • The FTP solution allows you only to upload files. Deleting them is an action that must be performed from My data in the Figshare interface.