All checks were successful
Build latest image / build-container (push) Successful in 1m29s
52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
---
|
|
title: Manage User Groups
|
|
weight: 4
|
|
prev: /admin/quickstart
|
|
next: /admin/usergroups
|
|
lang: en
|
|
---
|
|
|
|
As an admin, you can create user groups and assign users to them.
|
|
Users inherit the permissions of all the groups they belong to.
|
|
|
|
For example, you can put all admins in the `ADMINS` group instead of manually assigning permissions to each user.
|
|
|
|
## Create
|
|
|
|
To create a new user group, open the `User Groups` page in the runner system.
|
|
Click the `Create New Group` button to create a new user group.
|
|
You can give the group a name and (optionally) a description.
|
|
|
|
## Edit
|
|
|
|
To edit a user group, click the `Details` button for the desired group in the user groups overview.
|
|
In the overview for this user group, you can now adjust the name and description and view or edit permissions.
|
|
When you're done, just click `Save Changes`.
|
|
|
|
### Permissions
|
|
|
|
{{< callout type="info" >}}
|
|
There is a separate page for a user group's permissions.
|
|
{{< /callout >}}
|
|
|
|
To edit a group's permissions, click `Edit Permissions` on the group's detail page.
|
|
On the permissions page, there are two columns: `Available` (permissions the group does not have) and `Granted` (permissions the group has).
|
|
You can grant or remove permissions using the `+` and `-` buttons.
|
|
When you're done, just click `Save Changes`.
|
|
|
|
## Delete
|
|
|
|
You can delete a user group either from the user groups overview or the user group detail view.
|
|
Only the user group and its permissions will be deleted, not its users.
|
|
|
|
### In the User Groups Overview
|
|
|
|
Click the `Delete` button for the desired user group.
|
|
You will then be asked if you really want to delete the user group or cancel.
|
|
|
|
### In the User Group Detail View
|
|
|
|
Click the `Details` button for the desired user group.
|
|
At the top of the page, there is now a `Delete Group` button.
|
|
You will then be asked if you really want to delete the user group or cancel.
|