s3fs

Before you get started, you need to have already made a Satellite Account, Create an Access Grant and registered on the self-hosted S3-Compatible Gateway or generate credentials for Storj-hosted S3-Compatible Gateway.

See https://github.com/s3fs-fuse/s3fs-fuse for installation instructions for your OS.

You can use either Self-hosted S3 Compatible Gateway or Storj-hosted S3 Compatible Gateway. You only need S3 compatible credentials and endpoint.

Please substitute your own Access Key ID instead of ACCESS_KEY_ID and your own Secret Access Key instead of SECRET_ACCESS_KEY in the example below:

You can Create a Bucket with uplink, with AWS S3 CLI , or with Object Browser.

Create a folder:

Mount a bucket to the folder. We will assume that you created a bucket my-bucket earlier. We will use the endpoint https://gateway.storjshare.io here, as this will choose the right one for you automatically.

If you use the Self-hosted S3 Compatible Gateway, then the endpoint could be http://localhost:7777 (depends on your configuration and infrastructure).

You should make sure that the credentials file is available for the root on boot time. You can create it in the /etc/ folder:

Then add the following to /etc/fstab:

Check that it is working - The command:

should not return any error. Next, check that your Storj DCS bucket is mounted:

Now you can use the mounted bucket almost as any folder.

We recommend having a look at Rclone and its rclone mount command as well.

Please note - you can configure a native connector in rclone, (see: Rclone Native Integration) and use End-to-end Encryption, unlike Storj-hosted S3 Compatible Gateway which uses Server-side Encryption to provide a S3-compatible protocol (the S3 protocol does not use client side encryption by design).