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 
12min

s3fs

Prerequisites

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.

Install s3fs

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

Configure s3fs to use Storj DCS S3 Gateway

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

Create the credentials file

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:

Terminal
|

Create a bucket

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

Mount a bucket to the folder

Create a folder:

Terminal
|

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

Terminal
|

Mount a bucket to the folder on boot

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

Terminal
|

Then add the following to /etc/fstab:

Terminal
|

Check that it is working - The command:

Terminal
|

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

Terminal
|

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

See also

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

Updated 19 Jan 2023
Did this page help you?
Yes
No
UP NEXT
Splunk
Docs powered by archbee 
TABLE OF CONTENTS
Prerequisites
Install s3fs
Configure s3fs to use Storj DCS S3 Gateway
Create the credentials file
Create a bucket
Mount a bucket to the folder
Mount a bucket to the folder on boot
See also