From 589719f27ccbf3e423a18d4ee823b54c268fdd12 Mon Sep 17 00:00:00 2001 From: Cian Johnston Date: Tue, 11 Aug 2026 09:34:38 +0000 Subject: [PATCH 1/2] docs(prebuilt-workspaces): document prebuilds quota group behavior --- .../extending-templates/prebuilt-workspaces.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/admin/templates/extending-templates/prebuilt-workspaces.md b/docs/admin/templates/extending-templates/prebuilt-workspaces.md index 71b8dec9d5f..43e2bfd0070 100644 --- a/docs/admin/templates/extending-templates/prebuilt-workspaces.md +++ b/docs/admin/templates/extending-templates/prebuilt-workspaces.md @@ -265,11 +265,15 @@ Because unclaimed prebuilt workspaces are owned by the `prebuilds` user, you can 1. Configure quotas for any group that includes this user. 1. Set appropriate limits to balance prebuilt workspace availability with resource constraints. -When prebuilt workspaces are configured for an organization, Coder creates a "prebuilds" group in that organization and adds the prebuilds user to it. This group has a default quota allowance of 0, which you should adjust based on your needs: +When prebuilt workspaces are configured for an organization, Coder creates a `coderprebuiltworkspaces` group in that organization and adds the `prebuilds` user to it. +This group has a default quota allowance of 0, which you should adjust based on your needs: -- **Set a quota allowance** on the "prebuilds" group to control how many prebuilt workspaces can be provisioned -- **Monitor usage** to ensure the quota is appropriate for your desired number of prebuilt instances -- **Adjust as needed** based on your template costs and desired prebuilt workspace pool size +- **Set a quota allowance** on the `coderprebuiltworkspaces` group to control how many prebuilt workspaces can be provisioned. +- **Monitor usage** to ensure the quota is appropriate for your desired number of prebuilt instances. +- **Adjust as needed** based on your template costs and desired prebuilt workspace pool size. + +The `prebuilds` user is a system user, so it does not appear in the group's member list in the Coder dashboard or API, even though it is a member. +To set or verify the quota, use the group's **Quota Allowance** setting. If a quota is exceeded, the prebuilt workspace will fail provisioning the same way other workspaces do. From 936ba9ef33bc31ce147f44c1a5d9910f2e1ce02c Mon Sep 17 00:00:00 2001 From: Cian Johnston Date: Tue, 11 Aug 2026 09:34:38 +0000 Subject: [PATCH 2/2] docs(prebuilt-workspaces): document prebuilds quota group behavior --- .../templates/extending-templates/prebuilt-workspaces.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/admin/templates/extending-templates/prebuilt-workspaces.md b/docs/admin/templates/extending-templates/prebuilt-workspaces.md index 43e2bfd0070..d3aabfaf897 100644 --- a/docs/admin/templates/extending-templates/prebuilt-workspaces.md +++ b/docs/admin/templates/extending-templates/prebuilt-workspaces.md @@ -265,15 +265,15 @@ Because unclaimed prebuilt workspaces are owned by the `prebuilds` user, you can 1. Configure quotas for any group that includes this user. 1. Set appropriate limits to balance prebuilt workspace availability with resource constraints. -When prebuilt workspaces are configured for an organization, Coder creates a `coderprebuiltworkspaces` group in that organization and adds the `prebuilds` user to it. +When prebuilt workspaces are configured for an organization, Coder creates a group named `coderprebuiltworkspaces` (the **Prebuilt Workspaces** group) in that organization and adds the `prebuilds` user to it. This group has a default quota allowance of 0, which you should adjust based on your needs: -- **Set a quota allowance** on the `coderprebuiltworkspaces` group to control how many prebuilt workspaces can be provisioned. +- **Set a Quota Allowance** on the `coderprebuiltworkspaces` group to control how many prebuilt workspaces can be provisioned. - **Monitor usage** to ensure the quota is appropriate for your desired number of prebuilt instances. - **Adjust as needed** based on your template costs and desired prebuilt workspace pool size. -The `prebuilds` user is a system user, so it does not appear in the group's member list in the Coder dashboard or API, even though it is a member. -To set or verify the quota, use the group's **Quota Allowance** setting. +> [!NOTE] +> The `prebuilds` user is a system user, so it does not appear in the group's member list in the Coder dashboard or API, even though it is a member. If a quota is exceeded, the prebuilt workspace will fail provisioning the same way other workspaces do.