.. title:: Groups

Groups
========================

Groups are used to define roles for specific sets of users in Kasm Workspaces. By default there are two groups created
by the system, the Administrators group and the All Users group, the All Users group is the default group for every user
where statewide settings can be set.

Groups can be used to specify Kasm images and settings for different sets of users. For example, you may have a custom image for
developers with pre-installed developer tools. You can tie that image to a group. You can define settings for that group, such
as enabling bi-directional clipboard.

Create Group
-------------

Steps to create individual groups for sections of users.

* Select Groups tab from navigation menu

* Select Create New Group from the top right of the table

* Specify Group properties listed below

.. include:: /guide/groups/group_properties.rst

There are cards in the view group page that allow for the selection of its users

.. image:: /images/groups/group_users.jpg
    :scale: 70%


.. include:: /guide/groups/group_settings.rst

Group Images
------------
Administrators can define which Images are available to each group.
By default newly created images are automatically assigned to the **All Users** group. This behavior can be changed
by modifying the **Add Images To Default Group** global :doc:`Settings <settings>`.

.. image:: /images/groups/group_images.png
    :scale: 70%