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:

rclone config
rclone config

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

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n
e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n

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

name> waterbear
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
name> waterbear
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.

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

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
...
41 / Storj Decentralized Cloud Storage
\ (storj)
...
Storage> storj
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
...
41 / Storj Decentralized Cloud Storage
\ (storj)
...
Storage> storj

Choose your authentication method: existing access grant or new access grant from Create Access Grant in CLI (access token).

Storage> storj
Option provider.
Choose an authentication method.
Choose a number from below, or type in your own string value.
Press Enter for the default (existing).
1 / Use an existing access grant.
\ (existing)
2 / Create a new access grant from satellite address, API key, and passphrase.
\ (new)
provider>
Storage> storj
Option provider.
Choose an authentication method.
Choose a number from below, or type in your own string value.
Press Enter for the default (existing).
1 / Use an existing access grant.
\ (existing)
2 / Create a new access grant from satellite address, API key, and passphrase.
\ (new)
provider>

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

provider> 1
Option access_grant.
Access grant.
Enter a value. Press Enter to leave empty.
access_grant> 1cC...
--------------------
[waterbear]
type = storj
access_grant = 1cC...
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>
provider> 1
Option access_grant.
Access grant.
Enter a value. Press Enter to leave empty.
access_grant> 1cC...
--------------------
[waterbear]
type = storj
access_grant = 1cC...
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>

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.

provider> 2
Option satellite_address.
Satellite address.
Custom satellite address should match the format: `<nodeid>@<address>:<port>`.
Choose a number from below, or type in your own string value.
Press Enter for the default (us-central-1.storj.io).
1 / US Central 1
\ (us-central-1.storj.io)
2 / Europe West 1
\ (europe-west-1.storj.io)
3 / Asia East 1
\ (asia-east-1.storj.io)
satellite_address>
provider> 2
Option satellite_address.
Satellite address.
Custom satellite address should match the format: `<nodeid>@<address>:<port>`.
Choose a number from below, or type in your own string value.
Press Enter for the default (us-central-1.storj.io).
1 / US Central 1
\ (us-central-1.storj.io)
2 / Europe West 1
\ (europe-west-1.storj.io)
3 / Asia East 1
\ (asia-east-1.storj.io)
satellite_address>

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.

Option api_key.
API key.
Enter a value. Press Enter to leave empty.
api_key> 1Cjfjf...
Option api_key.
API key.
Enter a value. Press Enter to leave empty.
api_key> 1Cjfjf...

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

Option passphrase.
Encryption passphrase.
To access existing objects enter passphrase used for uploading.
Enter a value. Press Enter to leave empty.
passphrase> your-secret-encryption-phrase
Option passphrase.
Encryption passphrase.
To access existing objects enter passphrase used for uploading.
Enter a value. Press Enter to leave empty.
passphrase> your-secret-encryption-phrase

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 yand hit Enter to confirm it.

[waterbear]
type = storj
satellite_address = 121RTSDpyNZVcEU84Ticf2L1ntiuUimbWgfATz21tuvgk3vzoA6@asia-east-1.tardigrade.io:7777
api_key = 1Cjfjf...
passphrase = your-secret-encryption-phrase
access_grant = 1E1F...
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
[waterbear]
type = storj
satellite_address = 121RTSDpyNZVcEU84Ticf2L1ntiuUimbWgfATz21tuvgk3vzoA6@asia-east-1.tardigrade.io:7777
api_key = 1Cjfjf...
passphrase = your-secret-encryption-phrase
access_grant = 1E1F...
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y

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

Current remotes:

Name Type
==== ====
waterbear storj

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
Current remotes:

Name Type
==== ====
waterbear storj

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q

For a listing of Rclone commands for general use, see Rclone Commands.

Previous
Rclone Commands
Next
Restic