Single Tenant S3 Gateway

S3-compatible gateway for Storj V3 Network, based on a MinIO fork.

If you're looking for the rest of Storj's edge services, check out Edge.

Storj is building a decentralized cloud storage network. Check out our white paper for more info!

Storj is an S3-compatible platform and suite of decentralized applications that allows you to store data in a secure and decentralized manner. Your files are encrypted, broken into little pieces and stored in a global decentralized network of computers. Luckily, we also support allowing you (and only you) to retrieve those files!

Documentation

• Using the S3 Gateway
• S3 Compatibility

S3 API Compatibility

We support all essential API actions, like

• AbortMultipartUpload
• CompleteMultipartUpload
• CopyObject
• CreateBucket
• CreateMultipartUpload
• DeleteBucket
• DeleteObject
• DeleteObjects
• GetObject
• HeadBucket
• HeadObject
• ListBuckets
• ListMultipartUploads
• ListObjects
• ListObjectsV2
• ListParts
• PutObject
• UploadPart

as well as (Get/Put/Delete)ObjectTagging actions.

For more details on gateway's S3 compatibility, please refer to Compatibility Table.

Testing

Correctness

A suite of integration tests can be run on the checked out code.

make integration-run will start a new integration environment using Docker and run all the integration tests.

At the end of the run, you can run make integration-env-purge to remove the integration environment.

This requires docker to be installed on your local machine for this to work.

mint

We run mint tests based on MinIO's mint (gateway-mint) on every commit.

To run the tests:

make integration-env-start integration-mint-tests

You can also run a specific test using the TEST environment variable:

TEST=aws-sdk-php make integration-mint-tests

ceph/splunk-s3-tests

We run S3 tests based on Splunk's fork (which is better suited for us) of Ceph's S3 tests (splunk-s3-tests) on every commit.

To run the tests:

make integration-env-start integration-splunk-tests

License

This library is distributed under the Apache-2.0 license.

Support

If you have any questions or suggestions please reach out to us on our community forum or email us at support@storj.io.