Skip to content
SHC Docs

shc quota

manage resource quotas and limits

Reference for the quota CLI group. Source: modules/quota/commands/.

SubcommandDescription
scanscan and report resource usage
setset resource quotas
statusshow quota status
unsetremove resource quotas

scan and report resource usage

No declared flags. The global -t, -e and -s name the tenant, environment or deployment to measure. Every node measures the deployments it holds.

Source: modules/quota/commands/

set resource quotas

FlagTypeRequiredHelp
--scopestryesbase, tenant, environment or deployment
--cpustrnocpu limit
--memory / -mstrnomemory limit
--disk / -dstrnodisk limit
--max-deploymentsintnomaximum number of deployments
--max-environments / --max-envscast(type[str], int)nomaximum number of environments
--max-appscast(type[str], int)nomaximum number of apps
--max-vdeploymentscast(type[str], int)nomaximum number of vdeployments

Source: modules/quota/commands/

show quota status

No declared flags.

The text table carries a BASIS column saying what each USED cell is:

BasisAxesWhat the figure is
reservedcpu, memoryThe deploy-time reservation this scope is charged. Written by charge() from the compose reservations. Not live load: it does not fall when a deployment goes idle.
measured / unmeasureddiskA figure the daemon sampled, or the word unmeasured where no sweep has measured it.
counteddeployments, environments, apps, vdeploymentsAn exact count of objects.

Measured on bitspur compose01, 2026-09-09: shc quota status -t corp -s mailcow -e prod reported 8.1 cores and 10.8 GB, while docker stats over the same 14 containers showed 1.30% of one core and ~273 MiB. Both figures are correct; they answer different questions. For live per-container CPU and RSS, use docker stats on the node.

Source: modules/quota/commands/

remove resource quotas

FlagTypeRequiredHelp
--scopestryesbase, tenant, environment or deployment
--cpuboolnoremove CPU limit
--memory / -mboolnoremove memory limit
--disk / -dboolnoremove disk limit
--max-deploymentsboolnoremove max deployments limit
--max-environments / --max-envsboolnoremove max environments limit
--max-appsboolnoremove max apps limit
--max-vdeploymentsboolnoremove max vdeployments limit
--all / -aboolnoremove all quota limits

Source: modules/quota/commands/