From b471128cd4e2eaa3ae6376341b874fc102ad4272 Mon Sep 17 00:00:00 2001 From: Konrad Bucheli Date: Wed, 19 Feb 2025 08:22:08 +0100 Subject: [PATCH] correct desktop docs --- admin-guide/configuration/desktop/desktop.md | 28 +++++++++++++++----- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/admin-guide/configuration/desktop/desktop.md b/admin-guide/configuration/desktop/desktop.md index 25d28636..e49ec0a3 100644 --- a/admin-guide/configuration/desktop/desktop.md +++ b/admin-guide/configuration/desktop/desktop.md @@ -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.