tigris mk | Tigris Object Storage Documentation
Create a Bucket or Folder
Create a bucket (bare name) or a folder inside a bucket (bucket/folder/ with trailing slash).
Alias: create
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 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). |
--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
# 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 and buckets merge to keep a fork in sync with, or promote it back to, its source.