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

> ## 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 create

This command creates a user quota or a group quota for a directory on which a directory quota is set.

## Usage

```plaintext
userquota create --identifier-type username|groupname|uid|gid
                 --identifier IDENTIFIER
                 --quota-id ID
                 --quota-group-id ID
                 --user|--group
                 [--soft-limit LIMIT]
                 [--soft-limit-inodes LIMIT]
                 [--grace-period PERIOD]
                 [--hard-limit LIMIT]       
                 [--hard-limit-inodes LIMIT]
```

## Required Parameters

| `--identifier-type username\|groupname\|uid\|gid` | Determines how you want to identify the user or group for which a quota is created: - `username`. By the name of the user. - `groupname`. By the name of the group. - `uid`. By the user's UID. - `gid`. By the group's GID. |
| --- | --- |
| `--identifier IDENTIFIER` | Specify the identifier of the user or group for which the quota is created. The identifier must be of the type set with` --identifier-type`. |
| `--quota-id ID` | Identifies the directory quota under which the user or group quota is created. |
| `--quota-group-id ID` | Identifies the quota group associated with the user/group quota. |
| `--user\|--group` | Specify `--user` to configure a user quota or `--group` to configure a group quota. |

## 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** **NOTE**: A file with multiple hardlinks is counted only once. Specify `LIMIT` as an integer. |