> For the complete documentation index, see [llms.txt](https://docs.eazybackup.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eazybackup.com/e3-object-storage/advanced/configure-e3-bucket-quotas.md).

# Configure e3 Bucket Quotas

## How to enable a bucket quota in e3 Object Storage

Bucket quotas let you put **hard limits** on a specific bucket, so it can’t grow forever (accidentally or otherwise). Once a quota is enabled, **uploads and writes are rejected when the limit is exceeded**—ideal for cost control, tenant isolation, and preventing runaway jobs.

***

### What is a bucket quota?

A **bucket quota** is a limit applied to **one bucket** in e3 Object Storage. You can set quotas based on:

* **Storage amount** (how much data the bucket can hold), and/or
* **Object count** (how many objects/files can exist in the bucket)

You can use either one, or both together.

***

### Where to find bucket quotas in the dashboard

You’ll enable quotas from the bucket’s **Management** tab.

**Navigation:** `e3 Object Storage → Buckets → (select a bucket) → Management → Gear icon`

<figure><img src="https://2026595258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSvHh4wgiJn6bl81UXqVT%2Fuploads%2FSf2kEzyZz8Qcmmyknt4I%2Fbuckets_quota.png?alt=media&#x26;token=c4cff905-68c8-41cb-b0ea-9e2f5cb5db20" alt=""><figcaption></figcaption></figure>

***

### Step-by-step: Enable and configure a bucket quota

1. **Open e3 Object Storage** in the dashboard.
2. Click **Buckets**.
3. Find the bucket you want to limit.
4. Open the **Management** tab.
5. In the **Bucket quota** section, click the **Gear icon** (⚙️).

<figure><img src="https://2026595258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSvHh4wgiJn6bl81UXqVT%2Fuploads%2FoDn65Ymz5s2MsDkuvlV6%2Fbucket_quota_panel.png?alt=media&#x26;token=a4795c7c-1364-4b70-be37-d5690474ebba" alt="" width="274"><figcaption></figcaption></figure>

6. In the drawer, tick **Enable bucket quota**.
7. Set either (or both) limits:
   * **Max storage**: enter a number and choose a unit (ex: **GB**, **TB**)
   * **Max objects**: enter the maximum number of objects allowed
8. Close the drawer. Your settings apply immediately.

***

### Setting a storage quota (Max storage)

Use this when you want to cap the bucket by size (ex: “This bucket can’t exceed 500 GB”).

* In **Max storage**, set a value (example: `500`)
* Choose the **Unit** (GB/TB/etc.)

***

### Setting an object quota (Max objects)

Use this when you want to cap how many “things” can be stored (even if they’re small).

* In **Max objects**, set a value (example: `1,000,000`)

Good for: buckets that store lots of tiny files, API logs, thumbnails, versioned objects

***

### What does “-1” mean?

In the quota drawer you’ll see **-1** by default.

**-1 = unlimited** (no limit)

So:

* If you only want a **storage** limit, leave **Max objects** at **-1**
* If you only want an **object** limit, leave **Max storage** at **-1**
* If you want both, set both to real numbers

***

### What happens when the quota is reached?

When a bucket hits its quota:

* **New uploads/writes are rejected**
* Existing objects remain accessible (reads still work)
* Deleting objects (or reducing usage) will allow writes again once you’re back under the limit