# How Do I Configure Tigris Buckets?

Tigris buckets support public/private access, CORS, custom domains, lifecycle rules, storage tiers, webhook notifications, and shadow bucket migration. Most configuration is available via the CLI, SDK, or dashboard.

## Frequently Asked Questions[​](#frequently-asked-questions "Direct link to Frequently Asked Questions")

**Are buckets private by default?** Yes. All buckets and objects are private by default. Set access to `public` to make objects publicly accessible.

**Can I set CORS rules for browser access?** Yes. Configure CORS via the CLI or dashboard to allow browser requests to your bucket.

**Can I use a custom domain?** Yes. Map your domain to a Tigris bucket for branded URLs like `assets.example.com/image.png`.

**What storage tiers are available?** Standard, Standard IA (Infrequent Access), Glacier IR (Instant Retrieval), and Glacier.

## How Do I Create Public and Private Buckets?[​](#how-do-i-create-public-and-private-buckets "Direct link to How Do I Create Public and Private Buckets?")

```
# Private bucket (default)

tigris mk my-private-bucket



# Public bucket

tigris mk my-public-bucket --access public



# Change an existing bucket to public

tigris buckets set my-bucket --access public
```

With the Tigris SDK:

```
import { createBucket } from "@tigrisdata/storage";



await createBucket("my-bucket");
```

## How Do I Configure CORS for Browser Access?[​](#how-do-i-configure-cors-for-browser-access "Direct link to How Do I Configure CORS for Browser Access?")

```
tigris buckets set-cors my-bucket \

  --origins "https://example.com" \

  --methods "GET,PUT,POST" \

  --headers "Content-Type,Authorization" \

  --max-age 3600
```

This allows your web application at `example.com` to make requests directly to the bucket.

## How Do I Set Up a Custom Domain?[​](#how-do-i-set-up-a-custom-domain "Direct link to How Do I Set Up a Custom Domain?")

```
tigris buckets set my-bucket --custom-domain assets.example.com
```

Then add a CNAME record pointing `assets.example.com` to your bucket's Tigris hostname. See [Custom Domains](https://www.tigrisdata.com/docs/buckets/custom-domain.md) for full instructions.

## How Do I Set Object Expiration (TTL)?[​](#how-do-i-set-object-expiration-ttl "Direct link to How Do I Set Object Expiration (TTL)?")

Automatically delete objects after a certain number of days:

```
# Expire objects after 30 days

tigris buckets lifecycle create my-bucket --expire-days 30



# Expire objects on a specific date

tigris buckets lifecycle create my-bucket --expire-date 2026-12-31
```

## How Do I Configure Lifecycle Rules?[​](#how-do-i-configure-lifecycle-rules "Direct link to How Do I Configure Lifecycle Rules?")

Transition objects to cheaper storage tiers:

```
# Move to Infrequent Access after 30 days

tigris buckets lifecycle create my-bucket \

  --storage-class STANDARD_IA \

  --days 30



# Move to Glacier after 90 days

tigris buckets lifecycle create my-bucket \

  --storage-class GLACIER \

  --days 90
```

## What Storage Tiers Are Available?[​](#what-storage-tiers-are-available "Direct link to What Storage Tiers Are Available?")

| Tier          | Use Case                          | Cost    |
| ------------- | --------------------------------- | ------- |
| `STANDARD`    | Frequently accessed data          | Highest |
| `STANDARD_IA` | Infrequent access, fast retrieval | Lower   |
| `GLACIER_IR`  | Rare access, instant retrieval    | Lower   |
| `GLACIER`     | Archive, minutes to retrieve      | Lowest  |

## How Do I Enable Webhook Notifications?[​](#how-do-i-enable-webhook-notifications "Direct link to How Do I Enable Webhook Notifications?")

Receive HTTP notifications when objects are created or deleted:

```
# Set up a webhook

tigris buckets set-notifications my-bucket \

  --url https://example.com/webhook \

  --token my-auth-token



# Filter to specific prefixes

tigris buckets set-notifications my-bucket \

  --url https://example.com/webhook \

  --filter 'WHERE `key` REGEXP "^images"'



# Disable notifications

tigris buckets set-notifications my-bucket --disable
```

## How Do I Set Up Data Migration (Shadow Buckets)?[​](#how-do-i-set-up-data-migration-shadow-buckets "Direct link to How Do I Set Up Data Migration (Shadow Buckets)?")

Pull data on demand from an existing S3-compatible bucket:

```
tigris buckets set-migration my-bucket \

  --bucket source-bucket-name \

  --endpoint https://s3.amazonaws.com \

  --region us-east-1 \

  --access-key AKIA... \

  --secret-key ...



# Enable write-through (sync writes back to source)

tigris buckets set-migration my-bucket \

  --bucket source-bucket-name \

  --endpoint https://s3.amazonaws.com \

  --region us-east-1 \

  --access-key AKIA... \

  --secret-key ... \

  --write-through
```

See [Migrate from Any Provider](https://www.tigrisdata.com/docs/ai-agents/migrate-from-any-s3-provider.md) for details.

## Learn More[​](#learn-more "Direct link to Learn More")

* [Tigris Object Storage for AI Coding Agents](https://www.tigrisdata.com/docs/ai-agents.md)
* [Tigris CLI Quickstart](https://www.tigrisdata.com/docs/ai-agents/tigris-cli-quickstart.md)
* [Migrate from Any Provider](https://www.tigrisdata.com/docs/ai-agents/migrate-from-any-s3-provider.md)
* [CORS Configuration](https://www.tigrisdata.com/docs/buckets/cors.md)
* [Custom Domains](https://www.tigrisdata.com/docs/buckets/custom-domain.md)
* [Object Lifecycle Rules](https://www.tigrisdata.com/docs/buckets/object-lifecycle-rules.md)
* [Object Notifications](https://www.tigrisdata.com/docs/buckets/object-notifications.md)
