# tigris mk

Create a bucket (bare name) or a folder inside a bucket (bucket/folder/ with trailing slash).

**Alias:** `create`

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

```
tigris mk <path> [flags]

t3 create <path> [flags]
```

Paths support the optional `t3://` (or `tigris://`) prefix (e.g. `t3://my-bucket/path` or just `my-bucket/path`). A trailing slash creates a folder inside the bucket.

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

Flags only apply when creating a bucket (not folders).

| 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_IA`, `GLACIER`, `GLACIER_IR`                                                                                                                                                                   |
| `--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 bucket

tigris mk my-bucket



# Create a public bucket in a specific region

tigris mk my-bucket --access public --locations iad



# Create a bucket that allows per-object ACLs

tigris mk my-bucket --allow-object-acl



# Create a public bucket with directory listing enabled

tigris mk my-bucket --public --enable-directory-listing



# Create a folder in a bucket

tigris mk my-bucket/images/



# Using t3:// prefix

tigris mk t3://my-bucket



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

tigris mk my-fork --fork-of my-bucket



# Fork from a specific snapshot of the source bucket

tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
```

Forks are copy-on-write clones. Once created, use [`buckets rebase`](/docs/cli/buckets/rebase/.md) and [`buckets merge`](/docs/cli/buckets/merge/.md) to keep a fork in sync with, or promote it back to, its source.