Object Storage
Tigris is a globally distributed S3-compatible object storage service that stores data as objects within buckets. An object is a file and any metadata that describes the file. A bucket is a container for objects.
To store your data in Tigris, you first create a bucket and specify a bucket name. Then, you upload your data to that bucket as objects in Tigris. Each object has a key, which is the unique identifier for the object within the bucket. Buckets are global, and Tigris automatically stores the data close to your users. If your users move to a different region, the data moves with them.
Buckets and the objects in them are private and can be accessed only via access keys that you explicitly grant access permissions to.
Getting Started
1. Signup for an account
If you don't have an account, you can get yourself one here. Then follow the steps below.
2. Create a bucket
Before you can store data in Tigris, you have to create a bucket.
To create a bucket run the following command:
fly storage create
This will create a bucket, and either set the required environment variables for your Fly app or provide you with the secrets to set on your target app.
$ fly storage create
? Choose a name, use the default, or leave blank to generate one:
Your project (polished-thunder-5646) is ready. See details and next steps with:
Setting the following secrets on ot-demo:
AWS_ACCESS_KEY_ID: xxxxxxxxxxxxxxxxxxxx
AWS_ENDPOINT_URL_S3: https://fly.storage.tigris.dev
AWS_REGION: auto
AWS_SECRET_ACCESS_KEY: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
BUCKET_NAME: polished-thunder-5646
3. Start building
Now that you have a bucket, you can start storing objects in it. An object can be any kind of file: a text file, a photo, a video, or anything else. As Tigris is S3-compatible, you can use standard AWS S3 SDKs and libraries to store and retrieve objects.
Tigris provides a single global endpoint. When using the AWS S3 SDKs, all you
need is to set the endpoint to https://fly.storage.tigris.dev.
Take a look at examples of how to use Tigris with the most popular S3 SDKs and CLIs here.