On this page

In Tigris, buckets are global, each requiring a unique name. In addition, there are specific rules that must be followed when creating a bucket. Let's review these rules below.

## Rules

The following naming rules apply for buckets.

- Bucket name must be between [3, 63] characters
- Bucket name can only contain lowercase characters, numbers, dots, and hyphens.

Using a dot (.) will disable virtual-hosted style access on public content domains (e.g., `https://foo.bucket.t3.tigrisbucket.io`) for a bucket. However, you can still access it through a correctly configured [custom domain](/content/docs/buckets/custom-domain/index.html).

- Bucket names must not contain two adjacent periods
- Name must start with a number or a lowercase character
- Name must end with a number or a lowercase character
- Prefix `xn--` is reserved and not allowed in the bucket prefix
- Suffix `-s3alias` is reserved and not allowed in the bucket suffix
- Bucket name cannot be IP addresses

## Example bucket names

The following bucket names show examples of which characters are allowed in bucket names: `a-z, 0-9, dots (.), and hyphens (-)`.

```text
tigris-demo-bucket1-a1b2c3d4-5678-90ab-cdef-example11111
tigris-demo-bucket
example.com
www.example.com
my.example.tigris.bucket
```

The following example bucket names are not valid:

```text
tigris_demo_bucket (contains underscores)
TigrisDemoBucket (contains uppercase letters)
tigris-demo-bucket- (ends with a hyphen)
example..com (contains two adjacent periods)
192.168.5.4 (matches format of an IP address)
xn--examplebucket (starts with reserved prefix)
examplebucket-s3alias (ends with reserved suffix)
```