Rclone Native Integration
Selecting an Integration Pattern
Use our native Rclone integration to take advantage of client-side encryption, and to achieve the best possible download performance. Note that uploads will be erasure-coded locally Design Decision - End-to-end Encryption; thus, uploading a 1GB file will result in 2.68GB uploaded data out of your network (to storage nodes across the network).
Use this pattern (native integration) for:
- The strongest security
- The best download speeds
Alternatively, you can use the S3 compatible integration with Rclone to increase upload performance and reduce the load on your systems and network.
Setup
First, download rclone and extract the rclone binary onto your system.
Execute the config command to setup a new Storj "remote" configuration:
A text-based menu will prompt. Type n
and hit Enter
to create a new remote configuration.
Enter a name for the new remote configuration, e.g., waterbear
.
A long list of supported storage backends will prompt. Enter storj
and hit Enter
.
Choose your authentication method: existing access grant or new access grant from Create Access Grant in CLI (access token).
If you selected to authenticate with an existing access grant, enter the serialized access grant you have received by someone else.
If you selected to authenticate with a new access grant, first enter the satellite address by selecting one from the list or enter the address of a 3rd-party satellite.
If you enter a 3rd-party satellite, the address must also include the node ID of the satellite. This is required to establish a secure connection with the satellite.
The second step of creating a new access grant is to enter your generated Create Access Grant in CLI.
The final step of creating a new access grant is to enter your encryption passphrase.
The passphrase is used for encrypting and decrypting the data stored on Storj (formerly known as Tardigrade). If you have any data previously uploaded to this project, you must enter the same passphrase in order to download it successfully.
A summary of the remote configuration will prompt. Type y
and hit Enter
to confirm it.
Now you should see one remote configuration available. Enter q
and hit Enter
to quit the configuration wizard.
For a listing of Rclone commands for general use, see Rclone Commands.