# tigris buckets create

Create a new bucket with optional access, tier, and location settings.

**Alias:** `c`

## Usage[​](#usage "Direct link to Usage")

```
tigris buckets create [name] [flags]

t3 b c [name] [flags]
```

## Flags[​](#flags "Direct link to Flags")

| Name                                 | Required | Default    | Description                                                                                                                                                                                                                                         |
| ------------------------------------ | -------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--access`, `-a`                     | No       | `private`  | Access level. Options: `public`, `private`                                                                                                                                                                                                          |
| `--public`                           | No       | —          | Shorthand for `--access public`                                                                                                                                                                                                                     |
| `--enable-snapshots`, `-s`           | No       | `false`    | Enable snapshots for the bucket                                                                                                                                                                                                                     |
| `--allow-object-acl`                 | No       | `false`    | Allow per-object ACLs on the bucket                                                                                                                                                                                                                 |
| `--enable-directory-listing`         | No       | `false`    | Enable directory listing, relevant for public buckets                                                                                                                                                                                               |
| `--default-tier`, `-t`               | No       | `STANDARD` | Default storage tier. Options: `STANDARD` (Standard), `STANDARD_IA` (Infrequent Access), `GLACIER` (Archive), `GLACIER_IR` (Instant Retrieval Archive)                                                                                              |
| `--locations`, `-l`                  | No       | `global`   | Bucket location. Options: `global`, `usa`, `eur`, `ams`, `fra`, `gru`, `iad`, `jnb`, `lhr`, `nrt`, `ord`, `sin`, `sjc`, `syd`. Supports comma-separated values for dual region (e.g. `ams,fra`). See [locations docs](/docs/buckets/locations/.md). |
| `--fork-of`, `--fork`                | No       | —          | Create this bucket as a fork (copy-on-write clone) of the named source bucket                                                                                                                                                                       |
| `--source-snapshot`, `--source-snap` | No       | —          | Fork from a specific snapshot of the source bucket. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp. Requires `--fork-of`                                                                                              |
| `--consistency`, `-c`                | No       | —          | **Deprecated.** Use `--locations` instead.                                                                                                                                                                                                          |
| `--region`, `-r`                     | No       | —          | **Deprecated.** Use `--locations` instead.                                                                                                                                                                                                          |

## Examples[​](#examples "Direct link to Examples")

```
# Create a private bucket

tigris buckets create my-bucket



# Create a public bucket in a specific region

tigris buckets create my-bucket --access public --locations iad



# Create with snapshots and infrequent access tier

tigris buckets create my-bucket --enable-snapshots --default-tier STANDARD_IA



# Create a bucket that allows per-object ACLs

tigris buckets create my-bucket --allow-object-acl



# Create a public bucket with directory listing enabled

tigris buckets create my-bucket --public --enable-directory-listing



# Create a fork (copy-on-write clone) of an existing bucket

tigris buckets create my-fork --fork-of my-bucket



# Fork from a specific snapshot of the source bucket

tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
```

## Forks[​](#forks "Direct link to Forks")

A fork is a copy-on-write clone of a source bucket: it starts out sharing the source's data and only diverges as you write to it, so creating one is cheap regardless of the source's size. Use `--source-snapshot` to fork from a specific snapshot rather than the source's current state.

Once you have a fork you can keep it in sync with, or promote it back to, its source:

* [`buckets rebase`](/docs/cli/buckets/rebase/.md) — update a fork with the latest changes from its source
* [`buckets merge`](/docs/cli/buckets/merge/.md) — merge a fork's changes back into its source
* [`buckets list --forks-of`](/docs/cli/buckets/list/.md) — list the forks of a bucket