# Bucket Settings

Click on **Settings** to open the bucket configuration page.\
The **Bucket Settings** page allows users to configure bucket properties, versioning, security access, and storage limits.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FWYgPev6MzLXd8Omoozhg%2Fimage.png?alt=media&#x26;token=b467fa3e-8dee-42da-b198-29e5a0612c27" alt=""><figcaption></figcaption></figure>

***

**1. Basic Information**

The **Basic Information** section displays the core metadata and properties of the bucket.

**Bucket Name**

Displays the unique name assigned to the bucket when it was created.\
This name is used to identify and access the bucket within the object storage system.

**Region**

Indicates the geographical region where the bucket is hosted.\
The selected region determines **data locality, latency, and compliance requirements**.

**Current Size**

Shows the total storage currently used by all objects inside the bucket.

**Total Objects**

Displays the total number of objects stored in the bucket.

**Created On**

Shows the exact **date and time when the bucket was created**.

**Last Modified**

Displays the most recent timestamp when any object or configuration in the bucket was updated.

**Tags**

Tags allow users to attach **key–value metadata** to the bucket for easier organization, management, and automation.

Example:

```
Environment : Production
Project : Backup
```

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FVk2PMUtVkwbMtrMP0rFK%2Fimage.png?alt=media&#x26;token=2bb737cb-2fd1-411e-b5e4-b0de3020aa8c" alt=""><figcaption></figcaption></figure>

***

**2. Versioning Management**

The **Versioning Management** section controls the object versioning functionality for the bucket.\
\
**Version Control**

Version control enables the storage of **multiple versions of the same object**.

When **Versioning is Enabled:**

* Every update to an object creates a new version.
* Older versions are preserved.
* Deleted objects can be recovered.

This feature helps with:

* Data recovery
* Protection from accidental deletion
* Object rollback

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2F63VZWIXck0nFlCN2MjLj%2Fimage.png?alt=media&#x26;token=51b8aa4d-fc03-4240-8319-3e4f22658dfb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:**\
Once versioning is enabled, it **cannot be completely removed**. It can only be **turned off to stop creating new versions**, while existing versions remain stored.
{% endhint %}

***

**3. Security & Access**

The **Security & Access** section controls public accessibility of the bucket.

**Public Access**

This setting determines whether the bucket is publicly accessible.

When **Public Access is Enabled:**

* Anyone with the **object URL** can access the files.
* Files can be **viewed or downloaded without authentication**.

{% hint style="info" %}
**Warning:**\
Public buckets may expose sensitive data if not properly controlled.
{% endhint %}

**Public URL**

Displays the base URL used to access objects in the bucket.

Example:

```
https://bucket-name.region.storage-provider.com/object-key
```

Users can access objects by appending the **object key** to the public URL.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FDKLmpL8CMxm8c9M6xGVt%2Fimage.png?alt=media&#x26;token=4c0d0365-1339-45d6-89cb-a9347de3097f" alt=""><figcaption></figcaption></figure>

***

**4. Storage Management**

The **Storage Management** section allows administrators to configure limits on bucket storage usage.\
These limits help control how much storage space and how many objects can be stored in a bucket.

**a. Bucket Quota**

Bucket Quota allows administrators to set limits on storage consumption for a bucket.

Administrators can configure the following limits:

**b. Storage Limit**

Defines the maximum storage capacity allowed for the bucket.

**c. Object Limit**

Defines the maximum number of objects that can be stored in the bucket.

If no limits are configured, both values remain Unlimited, allowing unrestricted usage of the bucket.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FFtYF52zqx86H6pF4J3Bb%2Fimage.png?alt=media&#x26;token=a4fa79e6-26ba-469a-9368-1291111ece39" alt=""><figcaption></figcaption></figure>

***

**Configure Bucket Quota**

To configure storage limits for a bucket, follow the steps below.**Step 1: Open Bucket Quota Configuration**

1. Navigate to the **Bucket Settings** page.
2. Scroll down to the **Storage Management** section.
3. Locate the **Bucket Quota** option.
4. Click on the **Configure** button.

This opens the **Bucket Quota configuration panel**.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FQ6G11bkuS3O5FB27K4Im%2Fimage.png?alt=media&#x26;token=83bfce95-f2ba-4f03-8971-1e667da68f48" alt=""><figcaption></figcaption></figure>

**Step 2: Enable Bucket Quota**

1. Toggle **Enable Quota** to **ON**.
2. Once enabled, additional fields will appear for configuring limits.

Enabling quota allows administrators to control:

* Maximum storage usage
* Maximum number of objects stored in the bucket

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FFNG4RMlHp60SnsfW5YhT%2Fimage.png?alt=media&#x26;token=a7972c14-744a-4a4b-b3c9-3c0407a22cfe" alt=""><figcaption></figcaption></figure>

**Step 3: Configure Storage Limits**

After enabling quota, the following fields become available:

**a. Storage Limit (GB)**

Defines the **maximum storage capacity allowed for the bucket**.

Example:

```
100 GB
```

If the storage usage reaches this limit, the system prevents additional uploads until storage becomes available.

**b. Object Limit**

Defines the **maximum number of objects that can be stored in the bucket**.

Example:

```
10000 objects
```

Once this limit is reached, users cannot upload additional objects until some objects are deleted.

**Unlimited Storage or Objects**

If the **Storage Limit** and **Object Limit** fields are left empty:

* Storage remains **unlimited**
* Object count remains **unlimited**

**Step 4: Save Configuration**

After entering the desired limits:

1. Click **Save Changes** to apply the quota settings.
2. Click **Cancel** to discard any unsaved changes.

Once saved, the configured quota limits will be enforced for the bucket.
