Skip to content

group

!group

Category: access

Manage a Linux group via groupadd/groupmod/groupdel/gpasswd. Linux-only.

Parameters

NameTypeRequiredDescription
groupstringyesGroup name to manage.
gidintnoDesired numeric GID.
userslistnoMember usernames, managed via gpasswd -M.
appendboolnoWhen modifying users, add to existing members rather than replacing.
systemboolnoCreate a system group (groupadd -r), only when no gid given.
removeboolnoRemove the group instead of creating it.

Examples

- !group
  group: developers
  gid: 5000
  users:
    - alice
    - bob
  append: true