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).