---
title: "userquota create"
slug: "userquota-create"
tags: ["5.4"]
updated: 2026-10-28T01:52:52Z
published: 2026-10-28T01:52:52Z
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 or group quota rule for a specific directory quota.

##### Usage

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

##### Required Parameters

| `--identifier-type username\|groupname\|uid\|gid ` | Specify how you want to identify the user or group for which a quota is create: - `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 QUOTA_ID` | Identifies the directory quota under which the user or group quota is created. |
| `--user\|--group` | Specify `--user` to configure a user quota rule or `--group` to configure a group quota. |

##### Options

| `--grace-period` | Sets a grace period. If the specified user's or group's capacity usage continues to exceed the soft limit for the period of time set as the grace period, the user or group is blocked from writing to the directory. Specify `GRACE_PERIOD` in the format: `[DD] [HH:[MM:]]ss` or as an integer followed by d for days, h for hours, m for minutes, or s for seconds. Examples: - 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` |
| --- | --- |
| `--soft-limit` | Sets a capacity usage soft limit for the specified user/group. |
| `--hard-limit` | Sets a storage usage limit. No writes are allowed for the specified user/group beyond this limit. The value must be a complete integer and must be specified with a unit of measurement. Do not insert a space between the value and the unit of measurements. Valid units are: - Base 10: *KB*, *MB*, *GB*, *TB*, *PB*, *EB*, - Base 2: *KiB*, *MiB*, *GiB*, *TiB*, *PiB*, *EiB* |
| `--hard-limit-inodes` | Sets a limit on the number of directories and unique files the specified user/group can create under the path. A file with multiple hardlinks is counted only once. |
| `--soft-limit-inodes` | Sets a soft limit on the number of directories and unique files under the path. Warnings of exceeding the quota are issued when the limit is reached. A file with multiple hardlinks is counted only once. |