FileZilla Native Integration
Introduction
This guide walks users through the process around setting up FileZilla to transfer files over Storj DCS.
The native integration uses Design Decision: End-to-end Encryption for your object data, including metadata and path data.
This is the only integration available for the free version of Filezilla. If you wish to use the Hosted Gateway MT you will need the FileZilla Pro Integration
The FileZilla Client is a fast and reliable cross-platform (Windows, Linux and Mac OS X) FTP, FTPS and SFTP client with lots of useful features and an intuitive graphical user interface.
It includes a site manager to store all your connection details and logins, as well as an Explorer-style interface that shows the local and remote folders and can be customized independently.
With the launch of the native Storj DCS Integration into the FileZilla client, developers can use the client configured to transfer files, point-to-point using the decentralized cloud.
Getting Started
Create an Access Grant
Navigate to the Create an Access Grant page within your project and then click on Create S3 Credentials. A modal window will pop up where you should enter a name for this access grant.
If you click Encrypt My Access, our client-side javascript will finalize your access grant with your encryption passphrase. Your data will remain end-to-end encrypted until you explicitly register your access grant withAWS CLI and Hosted Gateway MT for S3 compatibility. Only then will your access grant be shared with our servers. Storj does not know or store your encryption passphrase.
However, if you are still reluctant to enter your passphrase into our web application, that's completely understandable, and you should cancel creation of Access Grant in Web UI, select Create Keys for CLI and follow these Create Access Grant in CLI.
The instructions below assume you selected Encrypt My Access.
Assign the permissions you want this access grant to have, then click on Encrypt My Access:
Select a Passphrase type: Either Enter your own Encryption Passphrase or Generate a 12-Word Mnemonic Passphrase. Make sure you save your encryption passphrase as you'll not be able to reset this after it's created.
Enter the Encryption Passphrase you used for your other access grants. If this is your first access grant, we strongly encourage you to use a mnemonic phrase as your encryption passphrase (The GUI automatically generates one on the client-side for you.)
This passphrase is important! Encryption keys derived from it are used to encrypt your data at rest, and your data will have to be re-uploaded if you want it to change!
Importantly, if you want two access grants to have access to the same data, they must use the same passphrase. You won't be able to access your data if the passphrase in your access grant is different than the passphrase you uploaded the data with.
Please note that Storj does not know or store your encryption passphrase, so if you lose it, you will not be able to recover your files.
Click either on the Copy to clipboard link or Download .txt and then confirm that you copied your Encryption Phrase to a safe place.
Click the Create my Access link to finish generating of Access Grant.
Please note that Storj does not know or store your encryption passphrase, so if you lose it, you will not be able to recover your files. Please store it in a safe place.
Downloading FileZilla
To download the latest release of FileZilla, navigate to https://filezilla-project.org/download.php?show_all=1 and select the version appropriate for your operating system, then install FileZilla.
Creating a new Site
Open the Site Manager by clicking on the leftmost icon.
Select the 'New Site' option
Configure the Satellite and Access Grant
Next, select Protocol: "Storj - Decentralized Cloud Storage" from the Protocol dropdown in the "General" tab.
Now enter the Satellite and Access Grant as shown below (Entering the port is not required)
- Use the Satellite URL from which you created the Access Grant.
- us1.storj.io (deprecated us-central-1.tardigrade.io)
- ap1.storj.io (deprecated asia-east-1.tardigrade.io)
- eu1.storj.io (deprecated europe-west-1.tardigrade.io)
- For Access Grant please enter the Access Grant you saved above.
After you enter the above information, hit the "Connect" button, and FileZilla will connect directly to the remote site. You should see a screen showing your local site vs. Storj DCS, like so:
Uploading a File
To upload a file to your local machine, simply drag it from the local to the remote site (on the decentralized cloud), as shown below:
Downloading a File
To download a file to your local machine, simply drag it from the remote site to the local site, as shown below:
