# Manage quotas using the GUI

Using the GUI, you can:

* [Set default directory quota](#set-default-directory-quota)
* [Set directory quota](#set-directory-quota)
* [View directory quotas and default quota](#view-directory-quotas-and-default-quota)
* [Update a directory quota or default quota](#update-a-directory-quota-or-default-quota)
* [Remove a directory quota](#remove-a-directory-quota)
* [Remove the default quota for new directories](#remove-the-default-quota-for-new-directories)

{% hint style="info" %}
To manage user or group quota, use the CLI. See [Manage quotas using the CLI](/weka-filesystems-and-object-stores/quota-management/quota-management.md).
{% endhint %}

## Set default directory quota

A default directory quota automatically applies quota limits to every new subdirectory created under a specified parent directory. It does not apply retroactively to existing subdirectories. Use it for cases where new directories should inherit consistent limits by default, such as user home directories or project folders.

**Before you begin**

Ensure a mount point to the relevant filesystem is set.

**Procedure**

1. From the menu, select **Manage > Directory Quotas**.
2. Select the **Default Directory Quotas** tab, then select **Create**.
3. Select the filesystem the default quota applies to..
4. In the **Create Default Quota** dialog, set the following fields:
   * **Directory Path:** The full path to the parent directory. New subdirectories created under this path will automatically inherit the quota.
   * **Hard Quota Limit:** The maximum capacity a subdirectory can use. Writes are blocked when this limit is reached.
   * **Soft Quota Limit:** The capacity threshold that starts the grace period timer. Writes are allowed until the grace period expires or the hard quota limit is reached.
   * **Owner:** Optional. An identifier for the directory owner, such as a username, email address, or Slack ID (up to 48 characters).
   * **Grace Period:** The time allowed after the soft quota limit is reached before writes are blocked.
5. Select **Save**.

<div data-with-frame="true"><figure><img src="/files/TsY0d1205aQ7Iuqjf1Xd" alt=""><figcaption><p>Set default directory quota</p></figcaption></figure></div>

## Set directory quota

The tenant admin can set a quota on a directory, which triggers a background task to calculate the current usage. Once this calculation is finished, the quota takes effect.

**Before you begin**

* To apply a quota to a directory, ensure there is a mount point for the relevant filesystem. Do not interrupt the quota set command until the quota accounting process is complete.
* Configure at least one Data Services container before setting any quotas. Without it, quota operations default to single-process mode, which may cause the CLI to hang for extended periods. In the GUI, the **Create** button for directory quotas is not available until a Data Services container is active. See [Set up a Data Services container for background tasks](/operation-guide/background-tasks/set-up-a-data-services-container-for-background-tasks.md).<br>

**Procedure**

1. From the menu, select **Manage > Directory Quotas**.
2. Select **Directory Quotas**.
3. Select the filesystem the directory quota applies to.
4. In the Create Quota dialog, set the following:
   * **Directory Path:** The full path to the directory quota to be set on.
   * **Hard Quota Limit:** The hard quota limit defines the maximum used capacity above the soft quota limit, which prevents writing to the directory.
   * **Soft Quota Limit:** The soft quota limit defines the maximum used capacity that triggers a grace period timer. Data can be written to the directory until the grace period ends or the hard quota limit is reached.
   * **Owner:** The directory’s owner, such as user name, email, or slack ID (up to 48 characters).
   * **Grace Period:** When the soft quota limit is reached, a grace period starts. After this period, data cannot be written to the directory.\
     The system sets the directory quota in the background.
5. To monitor the directory quota setting background task, select **Monitor > Background Tasks.**

<div data-with-frame="true"><figure><img src="/files/yEe7EAqZfEV2h59Hv5Uh" alt=""><figcaption><p>Set a directory quota and monitor the background task</p></figcaption></figure></div>

## View directory quotas and default quota

You can view existing directory quotas and the default quota that are already set.

**Procedure**

1. From the menu, select **Manage > Directory Quotas**.
2. Select the relevant tab: **Directory Quotas** or **Default Directories Quota**.
3. Select the filesystem in which the directory quotas are already set.
4. To view all quotas or only the exceeding quotas, select the **Exceeding quotas/All quotas** switch.

<div data-with-frame="true"><figure><img src="/files/XAli2nTmOkAEQphcu6t4" alt=""><figcaption><p>View directory quotas and default quota</p></figcaption></figure></div>

## Update a directory quota or default quota

You can update an existing directory quota or the default quota for directories. Updating the default quota only applies to new directories.

**Procedure**

1. From the menu, select **Manage > Directory Quotas**.
2. Select the relevant tab: **Directory Quotas** or **Default Directories Quota**.
3. Select the filesystem in which the directory quotas are set (through the CLI).
4. Select the three dots on the right of the required directory. From the menu, select **Update**.

<div data-with-frame="true"><figure><img src="/files/XXLKhoVyNhfSBoGOv39u" alt=""><figcaption><p>Directory Quotas</p></figcaption></figure></div>

5. In the Quota Settings Update dialog, modify the following settings according to your needs:
   * **Hard Quota Limit:** The hard quota limit defines the maximum used capacity above the soft quota limit, which prevents writing to the directory.
   * **Soft Quota Limit:** The soft quota limit defines the maximum used capacity that triggers a grace period timer. Data can be written to the directory until the grace period ends or the hard quota limit is reached.
   * **Owner:** The directory’s owner, such as user name, email, or slack ID (up to 48 characters).
   * **Grace Period:** When the soft quota limit is reached, a grace period starts. After this period, data cannot be written to the directory.
6. Click **Save**.

<div align="center" data-with-frame="true"><figure><img src="/files/NGVrTiZ4x7ngP9HeRAdV" alt="" width="264"><figcaption><p>Quota Settings Update</p></figcaption></figure></div>

## Remove a directory quota

You can remove (unset) a directory quota if it is no longer required.

**Procedure**

1. From the menu, select **Manage > Directory Quotas**.
2. Select the **Directory Quotas** tab.
3. Select the filesystem in which the directory quota is set.
4. Select the three dots on the right of the required default quota. From the menu, select **Remove**.
5. In the Quota Deletion message, select **Yes**.

<div data-with-frame="true"><figure><img src="/files/EAJPIyQ3AVVisi5U1hhe" alt=""><figcaption><p>Remove a default quota</p></figcaption></figure></div>

## Remove the default quota for new directories

You can remove (unset) the default quota settings for new directories created in a specific filesystem. The quota of existing directories is not affected.

**Procedure**

1. From the menu, select **Manage > Directory Quotas**.
2. Select the **Default Directories Quota** tab.
3. Select the filesystem in which the default quotas are already set.
4. Select the three dots on the right of the required default quota. From the menu, select **Remove**.
5. In the Default Quota Deletion message, select **Yes**.


---

# 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.weka.io/weka-filesystems-and-object-stores/quota-management/manage-quotas-using-the-gui.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.
