---
title: "userquota modify"
slug: "userquota-modify"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/userquota-modify"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# userquota modify

# 

This command modifies a user quota or a group quota.

## Usage

```plaintext
userquota modify --id ID
                 [--grace-period]
                 [--soft-limit]
                 [--hard-limit]
                 [--hard-limit-inodes]
                 [--soft-limit-inodes]
```

## Required Parameters

| `--id ID` | The ID of the user/group quota you want to modify. |
| --- | --- |

## Options to Set User/Group Quota Limits

| `--soft-limit LIMIT` | The soft limit of capacity usage for the user or group. When this limit is reached, a notification email is sent, and the grace period countdown commences. Writes are blocked only after the grace period expires. Specify LIMIT as a number followed by units of measure, for example: `--soft-limit 1gb` If not specified, no soft limit is applied. |
| --- | --- |
| `--soft-limit-inodes LIMIT` | The soft limit on the number of directories and unique files that the user or group can create in the quota directory. When this limit is reached, a notification email is sent, and the grace period countdown commences. Writes are blocked only after the grace period expires. **NOTE**: A file with multiple hardlinks is counted only once. |
| `--grace-period PERIOD` | A period during which writes to the quota directory are not blocked although the user or group has exceeded a soft limit. If the grace period is not set, exceeding a soft limit does not cause blocking of further writes to the quota directory. Specify `PERIOD` as follows: - As the number of time units followed by a time unit letter, for example: `10d`, `10h`, `10m`, `10s`. - The value is case-sensitive, entering `10D` or `10H` will return an error. - In the format `[DD] [HH:[MM:]]ss`. For example: - To specify 30 days, 20 hours, 15 minutes and 10 seconds: `--grace-period 30 20:15:10`. - To specify 18 hours: `--grace-period 18:00`. - To specify 7 days: `--grace-period 7d` |
| `--hard-limit LIMIT` | The limit of capacity usage above which no further writes are allowed for the user or group. When the hard limit is reached, the HARD_EXCEEDED alarm is raised. Specify `LIMIT` as an integer followed by a unit of measure (without a space in between). Valid units are: - Base 0: *KB*, *MB*, *GB*, *TB*, *PB*, *EB*, - Base2: *KiB*, *MiB*, *GiB*, *TiB*, *PiB*, *EiB* The units are case-insensitive. For example, `4gb` is valid. If not specified, no hard limit is applied. |
| `--hard-limit-inodes LIMIT` | The limit on the number of directories and unique files that the user or group can create in the quota directory, above which no further writes are allowed. **NOTE**: A file with multiple hardlinks is counted only once. Specify `LIMIT` as an integer. |