Skip to main content

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 for one of your Fly apps, run the following command in the directory where your Fly app is located:

fly storage create

This will create a bucket and set the required environment variables for you.

$ fly storage create
? Choose a name, use the default, or leave blank to generate one: demo-bucket
Your project (demo-bucket) is ready. See details and next steps with:

Setting the following secrets on ot-demo:

Secrets are staged for the first deployment

If you want to create a bucket that is not associated with a Fly app, you can run the same command outside of a Fly app directory.

$ fly storage create
? Select Organization: Ovais Tariq (personal)
? 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:

Set one or more of the following secrets on your target app.
AWS_ACCESS_KEY_ID: xxxxxxxxxxxxxxxxxxxx
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

Take a look at examples of how to use Tigris with the most popular S3 SDKs and CLIs here.