Controls/gitea-pages
0
2
Fork 0
Code Pull Requests Actions Activity

correct desktop docs

Browse Source
This commit is contained in:
buchel_k
2025-02-19 08:22:08 +01:00
parent 476e944ac3
commit b471128cd4
1 changed files with 21 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
admin-guide/configuration/desktop/desktop.md
View File

@@ -1,20 +1,34 @@
# Enabling Desktop Environment
A desktop/graphical interface can be enabled on any kind of systems (regardless of puppet role). This can be done as follows:
A desktop/graphical interface can be enabled on any kind of systems (regardless of puppet role).
## Full Desktop Configuation
A full desktop configuration with Gnome, office software and printing is enabled for the Puppet roles `role::workstation` and `role::console` or, independent of the role, in Hiera with
```
base::is_workstation: true
```
## Customized Desktop Configuration
But desktop features can also be individually be switched on or off.
For printing check out the [respective guide](printing).
The availability of the desktop is controlled with
```yaml
base::enable_desktop: true
```
By default this will install and enable Gnome as desktop and gdm as Display Manager. Without this setting the further options do not have any effect!
By default this will install and enable Gnome as desktop and gdm as Display Manager. Without below options do not have any effect!
The desktop configuration can be further refined and/or adapted by following keys:
```yaml
desktop::display_manager: gdm # available options: gdm (default), lightdm
# this will set the default session manager, however other avaiable options can still be selected at login time
desktop::session_manager: gnome-xorg # availale options: gnome-xorg (default), gnome-classic, xfce, ...
# this will set the default session manager aka desktop
desktop::session_manager: gnome-xorg # availale options: gnome-xorg (default on RHEL8), gnome-wayland (default on RHEL9), gnome-classic, xfce, ...
```
Individual desktops can be enabled/disabled via:
@@ -24,10 +38,10 @@ desktop::enable_xfce: true # false (default)
desktop::enable_icewm: true # false (default)
```
When enabling a desktop environment also the installation of desktop apps will automatically take place (including firefox, etc.). If you prefer a slim setup you can disable this by:
The installation of office applications can be enforced with
```yaml
desktop::enable_office_apps: false # default: true
desktop::enable_office_apps: true
```
Further refinements can be done as documented in the other guides in this section.