From 7619b3afdacce64533355cfc21f58d1e9728dc54 Mon Sep 17 00:00:00 2001 From: Achilleas Koutsou Date: Mon, 19 Jan 2026 13:13:27 +0100 Subject: [PATCH] blueprint-reference: add note describing new groups behaviour See https://github.com/osbuild/images/pull/2146/ --- docs/user-guide/01-blueprint-reference.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/user-guide/01-blueprint-reference.md b/docs/user-guide/01-blueprint-reference.md index 87ecb6d905b..c31ff3c053f 100644 --- a/docs/user-guide/01-blueprint-reference.md +++ b/docs/user-guide/01-blueprint-reference.md @@ -558,6 +558,8 @@ An *optional* list of objects that contain the following attributes: - `name` a **required** string that sets the name of the group. - `gid` a **required** integer that sets the id of the group. +*Note: Collisions caused by duplicate names or GIDs will be resolved automatically at build time. This includes system groups created by packages. Therefore, adding a group with a name that already exists on the system will have no effect. When specifying a GID that is already used by another group, another unique GID is chosen.* + ```toml