Skip to content
Install

A cluster has a fixed amount of CPU and memory, and every organization on the instance shares it. Quotas stop one person or project from using all of it, so a runaway deploy fails with a clear message instead of starving everyone else.

Quotas apply only when resource limits are on. If a superadmin turns limits off, Orchard does not check caps or allowances, and the Usage page shows Resource limits are off.

Orchard checks three limits when you create, scale, or resize an app or database:

  1. The organization cap, set by a superadmin.
  2. The project cap, if the project has its own. It covers the whole project, including its environments.
  3. The member allowance of the project owner.

Orchard refuses a request that does not fit, and the message names the limit. Apps that already run keep running, and you can still restart them.

Quotas count the CPU and memory that you select for an app. The resource picker shows the remaining budget while you size an app.

If an app cannot start because its project is out of room, the app page shows which limit is used up. For example, This app can't start: its project's memory limit is used up. To continue, raise the limit, or stop or shrink another app.

A member with no allowance of their own uses the organization’s default allowance. If the organization has no default, the member has no limit.

A cap or allowance must be greater than 0. To remove one, leave it blank.

You must be a superadmin.

  1. Go to Instance admin > Organizations.
  2. On the organization row, open the More menu and select Resource quotas.
  3. Set any of CPU (millicores), Memory (MiB), Max pods, Max services, Max projects, Max environments, and Max deployments. Leave a limit at Unlimited to remove it.
  4. Select Save quotas.

Orchard applies the quotas to the cluster when you save.

You must be an organization owner or admin.

  1. In your organization, go to Usage > Members.
  2. To set the default, select Edit in Default allowance.
  3. To set one person’s allowance, select the edit control on their row.

Go to Usage in your organization. Owners and admins see all of the following tabs. Other members see Yours.

Tab Shows
Organization Capacity against caps, and usage by project.
Yours The workloads that you own.
Members The default allowance, and each member’s usage against their allowance.
Right-sizing How workloads compare with their allocated resources.

Size apps from metrics over a time range instead of a single reading, so that the size covers the peak.

Every project has an owner, who is the person who created it unless ownership has moved. All apps and databases in the project count against the owner’s allowance.

The project owner, or an organization owner or admin, can start a transfer. The new owner must already be a member of the project.

To start a transfer from the dashboard:

  1. Go to the project Settings tab.
  2. In Danger zone, select Transfer next to Transfer ownership.
  3. In New owner, select the person.
  4. Select Send request.

To start a transfer from the CLI:

orchard project transfer request [email protected]

The recipient accepts or declines the request. The request expires after seven days. To list and accept requests from the CLI, run the following commands:

orchard project transfer list
orchard project transfer accept <REQUEST_ID>

Orchard rejects the transfer if the project does not fit in the new owner’s allowance. To continue, raise the allowance or reduce the project.

When the recipient accepts, they become a project admin. The previous owner keeps their current project role.