# 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="/files/0u5zIfbzU1KvAHF7hwv4" 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="/files/kVGibx2D3TCEBokSKZ6C" 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eazybackup.com/e3-object-storage/configure-e3-bucket-quotas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.