> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Object Storage

[Tigris](https://tigrisdata.com) is a globally caching, S3-compatible object storage service built on Fly.io infrastructure.

## Launching a new Application?

If `@aws-sdk/client-s3` is listed as a dependency in your `package.json`, Tigris will be automatically selected by fly launch. This can be overridden in the launch UI:

<img src="https://mintcdn.com/fly-io/uE4KNLArpeLTM_fo/images/tigris-launch-ui.png?fit=max&auto=format&n=uE4KNLArpeLTM_fo&q=85&s=5c791fa3e123adacd987604e64ef6426" alt="Tigris Launch-UI" width="857" height="106" data-path="images/tigris-launch-ui.png" />

## Adding Tigris to an existing application?

Create a storage bucket using `fly storage create`:

<CodeGroup>
  ```bash cmd theme={null}
  fly storage create
  ```

  ```output output theme={null}
  ? Choose a name, use the default, or leave blank to generate one: 
  Your Tigris project (xxx) is ready. See details and next steps with: https://fly.io/docs/tigris/

  Setting the following secrets on xxx:
  AWS_ACCESS_KEY_ID: tid_xxx
  AWS_ENDPOINT_URL_S3: https://fly.storage.tigris.dev
  AWS_REGION: auto
  AWS_SECRET_ACCESS_KEY: tsec_xxxxx
  BUCKET_NAME: xxx

  Secrets are staged for the first deployment
  ```
</CodeGroup>

## Usage

Once provisioned, no further configuration is required to access your bucket using the `S3Client` class:

```javascript theme={null}
const S3 = new S3Client()
```

## Demo

[`node-dictaphone`](https://github.com/fly-apps/node-dictaphone) contains a demo application that captures audio,
uploads the result to a Tigris bucket, where it can be selected and replayed:

```
fly launch --from https://github.com/fly-apps/node-dictaphone.git
```

## Find out more!

Now that you are up and running, there is a lot more to explore on the [Tigris Global Object Storage](/tigris) page. Highlights include public buckets, migrating to Tigris with shadow buckets, pricing, and AWS API compatibility.
