website logo
Create accountLogin
Home
DCS
Node
Resources
Help center
Navigate through spaces
Home
DCS
Node
Resources
Help center
⌘K
Storj DCS
Get Started
AWS CLI and Hosted Gateway MT
AWS SDK and Hosted Gateway MT
Uplink CLI
Satellite Admin Console
Object Browser
Downloads
Download Uplink CLI
Download Self-hosted S3 Compatible Gateway
Download Storj Client Libraries
SDKs & Reference
Tutorial
How-to Guides
Concepts
Support
Support Overview
FAQ
Community Forum
Status Page
Help Desk
Billing, Payment & Accounts
Resources
Moved Documents
Docs powered by archbee 
33min

Rclone Native Integration

Selecting an Integration Pattern

Use our native integration pattern to take advantage of client-side encryption as well as to achieve the best possible download performance. Uploads will be erasure-coded locally, thus a 1GB upload will result in 2.68GB of data being uploaded to storage nodes across the network.

Use this pattern for

  • The strongest security
  • The best download speeds

Setup

First, Download and extract the rclone binary onto your system.

Execute the config command:

Text
|

A text-based menu will prompt. Type n and hit Enter to create a new remote configuration.

Text
|

Enter a name for the new remote configuration, e.g. waterbear.

Text
|

A long list of supported storage backends will prompt. Enter storj and hit Enter.

Text
|

Choose your authentication method: existing access grant or new access grant from API Key (access token).

Text
|

If you selected to authenticate with an existing access grant, enter the serialized access grant you have received by someone else.

Text
|

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.

Text
|

If you enter the a 3rd-party satellite, the address must include also 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 API key.

Text
|

The final step of creating a new access grant is to enter your encryption passphrase.

Text
|

The passphrase is used for encrypting and decrypting the data stored on Storj DCS (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 yand hit Enter to confirm it.

Text
|

Now you should see one remote configuration available. Enter q and hit Enter to quit the configuration wizard.

Text
|

For additional security, you should consider using the (s) option

Set configuration password option. It will encrypt the rclone.conf configuration file. This way secrets like the API Key (access token), the encryption passphrase, and the access grant won't be stolen if an attacker get access to your configuration file.

Create a Bucket

Use the mkdir command to create new bucket, e.g. mybucket.

|

List All Buckets

Use the lsf command to list all buckets.

|

Note the colon (:) character at the end of the command line.

Delete a Bucket

Use the rmdir command to delete an empty bucket.

|

Use the purge command to delete a non-empty bucket with all its content.

|

Upload Objects

Use the copy command to upload an object.

|

The --progress flag is for displaying progress information. Remove it if you don't need this information.

Use a folder in the local path to upload all its objects.

|

Only modified files will be copied.

List Objects

Use the ls command to list recursively all objects in a bucket.

|

Add the folder to the remote path to list recursively all objects in this folder.

|

Use the lsf command to list non-recursively all objects in a bucket or a folder.

|

Download Objects

Use the copy command to download an object.

|

The --progress flag is for displaying progress information. Remove it if you don't need this information.

Use a folder in the remote path to download all its objects.

|

Delete Objects

Use the deletefile command to delete a single object.

|

Use the delete command to delete all object in a folder.

|

Print the Total Size of Objects

Use the size command to print the total size of objects in a bucket or a folder.

|

Sync Two Locations

Use the sync command to sync the source to the destination, changing the destination only. Doesn’t transfer unchanged files, testing by size and modification time or MD5SUM. Destination is updated to match source, including deleting files if necessary.

|

The --progress flag is for displaying progress information. Remove it if you don't need this information.

Since this can cause data loss, test first with the --dry-run flag to see exactly what would be copied and deleted.

The sync can be done also from Storj DCS to the local file system.

|

Or between two Storj DCS buckets.

|

Or even between another cloud storage and Storj DCS.

|
Updated 23 Jan 2023
Did this page help you?
Yes
No
UP NEXT
Rclone Hosted Gateway
Docs powered by archbee 
TABLE OF CONTENTS
Selecting an Integration Pattern
Use this pattern for
Setup
Create a Bucket
List All Buckets
Delete a Bucket
Upload Objects
List Objects
Download Objects
Delete Objects
Print the Total Size of Objects
Sync Two Locations