Difference between revisions of "Storj"

From FileZilla Wiki
Jump to navigationJump to search
Line 53: Line 53:
  
 
Not currently, this feature can be supported in the future, when file ids are unique, see deprecation messages at https://github.com/Storj/service-storage-models/blob/master/lib/models/bucketentry.js#L115-L119
 
Not currently, this feature can be supported in the future, when file ids are unique, see deprecation messages at https://github.com/Storj/service-storage-models/blob/master/lib/models/bucketentry.js#L115-L119
 +
 +
=== What do I do if I see "Transfer rate limit" error ===
 +
 +
This means that a rate limit on the number of bytes uploaded or downloaded has been reached. These are calculated time spans by hour, day and month. Accounts that have billing information entered currently do not have these rate limits, and instead have a rate limit on the total number of requests, which can be seen as a "Too many requests" error.
  
 
= Community & Support =
 
= Community & Support =

Revision as of 18:12, 27 June 2017

Storj is a decentralized peer-to-peer file storage system, and new protocol being added to FileZilla.

Source code is available at https://svn.filezilla-project.org/filezilla/FileZilla3/branches/storj/ and depends on https://github.com/Storj/libstorj

To checkout the code with subversion:

   svn co https://svn.filezilla-project.org/svn/FileZilla3/branches/storj/ filezilla

Getting Started

  • Add a new site in the Site Manager and select Storj as the protocol
  • Enter api.storj.io as the host and 443 as the port
  • Enter the bridge user name and password
  • If you have not created an Encryption Key before, generate a new one, otherwise add your existing key
  • Connect to the server and begin uploading and downloading files

Frequently Asked Questions

What is an Encryption Key?

The Encryption Key is a series of 12 to 24 words that represents 128 to 256 bits of entropy that is used to encrypt files before they are uploaded into the network.

Here is an example Encryption Key:

   legal winner thank year wave sausage worth useful legal winner thank year wave sausage worth useful legal will

If you're familiar with Bitcoin, this will be recognizable as it's based on the BIP39 standard.

How do I export settings from libstorj CLI?

First run this command to get the bridge user, password and the encryption key:

   storj export-keys

And then enter those settings into FileZilla in the Getting Started section.

What does it mean if I see "Error: Wrong encryption key for at least one bucket"?

This means that a bucket was added using a different Encryption Key and you won't be able to download the files within that bucket as it won't be able to decrypt or verify their integrity.

Why is there more data transfered over the wire compared to the total size of the file?

Files are encoded with Reed Solomon error correction before they are uploaded to the network. This provides the ability to repair parts of the file that are missing or inaccessible. The number of parity shards is currently calculated as 2/3 of the original file size.

How are files encoded before being uploaded to the Storj network?

Files are first encrypted using the Encryption Key and then encoded using Reed Solomon into various size shards. For specific details please read SIP5. These shards are then uploaded to different nodes in the Storj network directly after communicating with the Storj bridge to negotiate which nodes to communicate with. After the file is uploaded, it is then mirrored to other nodes in the network, so that in the event that a shard goes missing after this initial upload, a shard can be repaired. The total number of shards that can be repaired is around 1/2 of the original file.

Note: For larger files the time it takes to do this preparation step can be more noticeable.

Can I rename or move files?

Not currently, this feature can be supported in the future, when file ids are unique, see deprecation messages at https://github.com/Storj/service-storage-models/blob/master/lib/models/bucketentry.js#L115-L119

What do I do if I see "Transfer rate limit" error

This means that a rate limit on the number of bytes uploaded or downloaded has been reached. These are calculated time spans by hour, day and month. Accounts that have billing information entered currently do not have these rate limits, and instead have a rate limit on the total number of requests, which can be seen as a "Too many requests" error.

Community & Support

Please sign up for the Storj community chat at: https://community.storj.io/ and ask any questions you may have in the #filezilla channel.

Debugging

It's possible to view full detailed logs for file transfers. To enable it (you'll need to do this each time you start up):

  • Open up the Preferences/Settings
  • Go to Logging and optionally enable timestamps and select a file to log
  • Go to Debug and select "4 - Debug"
  • View logs in the command console