diff --git a/_toc.yml b/_toc.yml index a5387cc4..9e8e4339 100644 --- a/_toc.yml +++ b/_toc.yml @@ -90,6 +90,7 @@ chapters: - file: admin-guide/configuration/files/sftp_server - file: admin-guide/configuration/desktop sections: + - file: admin-guide/configuration/desktop/desktop - file: admin-guide/configuration/desktop/gnome - file: admin-guide/configuration/desktop/keyboard_layout - file: admin-guide/configuration/desktop/xrdp diff --git a/admin-guide/configuration/desktop/_static/desktop_profile.excalidraw b/admin-guide/configuration/desktop/_static/desktop_profile.excalidraw new file mode 100644 index 00000000..5fc693bd --- /dev/null +++ b/admin-guide/configuration/desktop/_static/desktop_profile.excalidraw @@ -0,0 +1,1070 @@ +{ + "type": "excalidraw", + "version": 2, + "source": "https://excalidraw.com", + "elements": [ + { + "type": "arrow", + "version": 210, + "versionNonce": 773687472, + "index": "b00", + "isDeleted": false, + "id": "i-TcXxnm4U_5weLUwaZKC", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 737.1301390230093, + "y": 56, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "width": 362.8394303860613, + "height": 116.52494524386714, + "seed": 1774320879, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 2 + }, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "startBinding": { + "elementId": "iURU4cM1iSu4UBJwDjTGZ", + "focus": -0.048157023030437035, + "gap": 11, + "fixedPoint": null + }, + "endBinding": { + "elementId": "jCuzfFFGZpqKwRYA2sslz", + "focus": -0.3805678546118675, + "gap": 1, + "fixedPoint": null + }, + "lastCommittedPoint": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "points": [ + [ + 0, + 0 + ], + [ + 362.8394303860613, + 116.52494524386714 + ] + ], + "elbowed": false + }, + { + "id": "2-KKbdZLD1wELjtEvSdzr", + "type": "rectangle", + "x": 401, + "y": 271, + "width": 92, + "height": 73, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b01", + "roundness": { + "type": 3 + }, + "seed": 399608033, + "version": 86, + "versionNonce": 1927322192, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false + }, + { + "type": "rectangle", + "version": 73, + "versionNonce": 482931376, + "index": "b02", + "isDeleted": false, + "id": "ysjk0fahBNb5g_ak66NTI", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 600, + "y": 266.5, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "width": 92, + "height": 73, + "seed": 875744353, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "boundElements": [ + { + "id": "X6DGJwvQiJ-h5Au1acBP_", + "type": "arrow" + } + ], + "updated": 1730908458556, + "link": null, + "locked": false + }, + { + "type": "rectangle", + "version": 112, + "versionNonce": 645451856, + "index": "b03", + "isDeleted": false, + "id": "Lx0Dd5nKo3gDcD-U43Uwj", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 795, + "y": 263.5, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "width": 92, + "height": 73, + "seed": 1704766671, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false + }, + { + "id": "L0M_MdtgJK1Ty36iyZ4wk", + "type": "text", + "x": 807, + "y": 358, + "width": 78.15999603271484, + "height": 25, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b04", + "roundness": null, + "seed": 1088913327, + "version": 54, + "versionNonce": 913775792, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "text": "desktop", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "desktop", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "UbO_KLJ3Fdw9V1ZUmX5Zx", + "type": "text", + "x": 572, + "y": 359, + "width": 155.84002685546875, + "height": 25, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b05", + "roundness": null, + "seed": 2068754785, + "version": 59, + "versionNonce": 1704609360, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "text": "session-manager", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "session-manager", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "dJeU6CW9Ow7aUfRIHA-P6", + "type": "text", + "x": 379, + "y": 360, + "width": 150.32003784179688, + "height": 25, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b06", + "roundness": null, + "seed": 916283247, + "version": 80, + "versionNonce": 214959792, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "text": "display-manager", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "display-manager", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "V6v0H24LQe9TRIIHvKURS", + "type": "text", + "x": 416, + "y": 431, + "width": 68.24000549316406, + "height": 50, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b07", + "roundness": null, + "seed": 353426689, + "version": 14, + "versionNonce": 1830616144, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "text": "gdm\nlightdm", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "gdm\nlightdm", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "0Fs-nmZNoMgjQnaUbjADA", + "type": "text", + "x": 609, + "y": 421, + "width": 139.86001586914062, + "height": 125, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b08", + "roundness": null, + "seed": 704674127, + "version": 75, + "versionNonce": 418920556, + "isDeleted": false, + "boundElements": [], + "updated": 1731416627531, + "link": null, + "locked": false, + "text": "gnome-xorg\ngnome-wayland\ngnome-classic\nxfce\n...", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "gnome-xorg\ngnome-wayland\ngnome-classic\nxfce\n...", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "X6DGJwvQiJ-h5Au1acBP_", + "type": "arrow", + "x": 519, + "y": 307, + "width": 64, + "height": 0, + "angle": 0, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b09", + "roundness": { + "type": 2 + }, + "seed": 1449781953, + "version": 17, + "versionNonce": 517534288, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 64, + 0 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": { + "elementId": "ysjk0fahBNb5g_ak66NTI", + "focus": -0.1095890410958904, + "gap": 17, + "fixedPoint": null + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "type": "arrow", + "version": 57, + "versionNonce": 220338864, + "index": "b0A", + "isDeleted": false, + "id": "fVUYVAnscnkDQpC9w3qYJ", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 709.9628626323026, + "y": 303.5519597529316, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "width": 64, + "height": 0, + "seed": 142099809, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 2 + }, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "startBinding": null, + "endBinding": null, + "lastCommittedPoint": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "points": [ + [ + 0, + 0 + ], + [ + 64, + 0 + ] + ], + "elbowed": false + }, + { + "id": "1aZZupmz0IL17oNRXVAB0", + "type": "text", + "x": 555, + "y": 44, + "width": 144.6800079345703, + "height": 25, + "angle": 0, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b0B", + "roundness": null, + "seed": 1817171233, + "version": 76, + "versionNonce": 1638279248, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "text": "profile.desktop", + "fontSize": 20, + "fontFamily": 5, + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "profile.desktop", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "text", + "version": 256, + "versionNonce": 292242608, + "index": "b0C", + "isDeleted": false, + "id": "hqbgFqv5SQai0IxYPfWHR", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 385.65999603271484, + "y": 186.5, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "width": 134.75999450683594, + "height": 50, + "seed": 846427137, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [ + { + "id": "7BetjecKwL40_bxD4kMG6", + "type": "arrow" + } + ], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 20, + "fontFamily": 5, + "text": "profile.gdm\nprofile.ligthdm", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "profile.gdm\nprofile.ligthdm", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "text", + "version": 231, + "versionNonce": 22847056, + "index": "b0D", + "isDeleted": false, + "id": "sgeAiSoNtmkkUDqPxXIWg", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 786.620002746582, + "y": 184, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "width": 124.13999938964844, + "height": 50, + "seed": 465673377, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 20, + "fontFamily": 5, + "text": "profile.gnome\nprofile.xfce", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "profile.gnome\nprofile.xfce", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "id": "O1DqGB2gPQlPAwonT1phu", + "type": "arrow", + "x": 543, + "y": 80, + "width": 58, + "height": 28, + "angle": 0, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b0E", + "roundness": { + "type": 2 + }, + "seed": 1001465583, + "version": 64, + "versionNonce": 1191128752, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -58, + 28 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": { + "elementId": "BsAVKvplXbW64q8AjUuPF", + "focus": -0.3053039011162528, + "gap": 13, + "fixedPoint": null + }, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "K7DqlaiHR7nxla8rtAfcg", + "type": "arrow", + "x": 645, + "y": 96, + "width": 1, + "height": 127, + "angle": 0, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b0F", + "roundness": { + "type": 2 + }, + "seed": 104022497, + "version": 65, + "versionNonce": 248796240, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -1, + 127 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "0hsN4LBogxU2vwzsQRP26", + "type": "arrow", + "x": 713, + "y": 86, + "width": 99, + "height": 79, + "angle": 0, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b0G", + "roundness": { + "type": 2 + }, + "seed": 851749537, + "version": 43, + "versionNonce": 914741424, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 99, + 79 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "type": "text", + "version": 249, + "versionNonce": 1071991376, + "index": "b0H", + "isDeleted": false, + "id": "BsAVKvplXbW64q8AjUuPF", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 367.62000274658203, + "y": 121, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "width": 208.62002563476562, + "height": 25, + "seed": 1416583073, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [ + { + "id": "O1DqGB2gPQlPAwonT1phu", + "type": "arrow" + }, + { + "id": "7BetjecKwL40_bxD4kMG6", + "type": "arrow" + } + ], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 20, + "fontFamily": 5, + "text": "profile.displaymanager", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "profile.displaymanager", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "arrow", + "version": 141, + "versionNonce": 329728688, + "index": "b0I", + "isDeleted": false, + "id": "7BetjecKwL40_bxD4kMG6", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 456.4140261019394, + "y": 155.4139667158201, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "width": 2, + "height": 24, + "seed": 72670543, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 2 + }, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "startBinding": { + "elementId": "BsAVKvplXbW64q8AjUuPF", + "focus": 0.1299440657812496, + "gap": 9.413966715820095, + "fixedPoint": null + }, + "endBinding": { + "elementId": "hqbgFqv5SQai0IxYPfWHR", + "focus": -0.018712078448140674, + "gap": 7.086033284179905, + "fixedPoint": null + }, + "lastCommittedPoint": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "points": [ + [ + 0, + 0 + ], + [ + -2, + 24 + ] + ], + "elbowed": false + }, + { + "id": "IGa5lHIFV6mHR82pIwu8x", + "type": "text", + "x": 136, + "y": 155.5, + "width": 290.36798095703125, + "height": 20, + "angle": 0, + "strokeColor": "#ff8787", + "backgroundColor": "#ffffff", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "groupIds": [], + "frameId": null, + "index": "b0J", + "roundness": null, + "seed": 1523851663, + "version": 150, + "versionNonce": 1332183120, + "isDeleted": false, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "text": "desktop:displaymanager: gdm(default)", + "fontSize": 16, + "fontFamily": 5, + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "desktop:displaymanager: gdm(default)", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "text", + "version": 314, + "versionNonce": 1561029808, + "index": "b0K", + "isDeleted": false, + "id": "iURU4cM1iSu4UBJwDjTGZ", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 707.8799896240234, + "y": 67, + "strokeColor": "#ff8787", + "backgroundColor": "#ffffff", + "width": 290.83197021484375, + "height": 60, + "seed": 661369473, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [ + { + "id": "i-TcXxnm4U_5weLUwaZKC", + "type": "arrow" + } + ], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 16, + "fontFamily": 5, + "text": "desktop:enable_gnome: true (default)\ndesktop:enable_xfce: false (default)\n...", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "desktop:enable_gnome: true (default)\ndesktop:enable_xfce: false (default)\n...", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "text", + "version": 297, + "versionNonce": 1563620944, + "index": "b0L", + "isDeleted": false, + "id": "7ketfPTzB-_M2hx40HDyA", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 1031.9300003051758, + "y": 190, + "strokeColor": "#3bc9db", + "backgroundColor": "#ffffff", + "width": 201.9400177001953, + "height": 25, + "seed": 1935163151, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 20, + "fontFamily": 5, + "text": "profile.desktop_apps", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "profile.desktop_apps", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "rectangle", + "version": 148, + "versionNonce": 2086295216, + "index": "b0M", + "isDeleted": false, + "id": "zbyi0CaoHAZR9QzSModbY", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 1064, + "y": 264.5, + "strokeColor": "#1e1e1e", + "backgroundColor": "transparent", + "width": 92, + "height": 73, + "seed": 759386177, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false + }, + { + "type": "text", + "version": 100, + "versionNonce": 1310698576, + "index": "b0N", + "isDeleted": false, + "id": "Biyln1Tmh6MBlaTjpSxuA", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 1043.9200019836426, + "y": 357.5, + "strokeColor": "#1e1e1e", + "backgroundColor": "#ffffff", + "width": 199.4600067138672, + "height": 25, + "seed": 719340449, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 20, + "fontFamily": 5, + "text": "desktop applications", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "desktop applications", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "text", + "version": 315, + "versionNonce": 1715208368, + "index": "b0O", + "isDeleted": false, + "id": "7sdMvWFepJylS-vYM82ev", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 614.8799896240234, + "y": 124, + "strokeColor": "#ff8787", + "backgroundColor": "#ffffff", + "width": 481.4720458984375, + "height": 20, + "seed": 1494910625, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 16, + "fontFamily": 5, + "text": "desktop:sessionmanager: gnome-x11 / gnome-wayland (default)", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "desktop:sessionmanager: gnome-x11 / gnome-wayland (default)", + "autoResize": true, + "lineHeight": 1.25 + }, + { + "type": "text", + "version": 426, + "versionNonce": 738566736, + "index": "b0P", + "isDeleted": false, + "id": "jCuzfFFGZpqKwRYA2sslz", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 1, + "opacity": 100, + "angle": 0, + "x": 985.2639770507812, + "y": 157, + "strokeColor": "#ff8787", + "backgroundColor": "#ffffff", + "width": 353.072021484375, + "height": 20, + "seed": 541836289, + "groupIds": [], + "frameId": null, + "roundness": null, + "boundElements": [ + { + "id": "i-TcXxnm4U_5weLUwaZKC", + "type": "arrow" + } + ], + "updated": 1730908458556, + "link": null, + "locked": false, + "fontSize": 16, + "fontFamily": 5, + "text": "desktop:enable_desktop_apps: true (default)", + "textAlign": "left", + "verticalAlign": "top", + "containerId": null, + "originalText": "desktop:enable_desktop_apps: true (default)", + "autoResize": true, + "lineHeight": 1.25 + } + ], + "appState": { + "gridSize": 20, + "gridStep": 5, + "gridModeEnabled": false, + "viewBackgroundColor": "#ffffff" + }, + "files": {} +} \ No newline at end of file diff --git a/admin-guide/configuration/desktop/_static/desktop_profile.svg b/admin-guide/configuration/desktop/_static/desktop_profile.svg new file mode 100644 index 00000000..fcce0ae1 --- /dev/null +++ b/admin-guide/configuration/desktop/_static/desktop_profile.svg @@ -0,0 +1,10 @@ + + + + + + + + desktopsession-managerdisplay-managergdmlightdmgnome-xorggnome-waylandgnome-classicxfce...profile.desktopprofile.gdmprofile.ligthdmprofile.gnomeprofile.xfceprofile.displaymanagerdesktop:displaymanager: gdm(default)desktop:enable_gnome: true (default)desktop:enable_xfce: false (default)...profile.desktop_appsdesktop applicationsdesktop:sessionmanager: gnome-x11 / gnome-wayland (default)desktop:enable_desktop_apps: true (default) \ No newline at end of file diff --git a/admin-guide/configuration/desktop/alternative_desktops.md b/admin-guide/configuration/desktop/alternative_desktops.md index e7d5e69a..c9a800f3 100644 --- a/admin-guide/configuration/desktop/alternative_desktops.md +++ b/admin-guide/configuration/desktop/alternative_desktops.md @@ -4,11 +4,11 @@ Per default Gnome is installed, but sometimes there is the wish for other Deskto When changing the default desktop, please check the last chapter "Reset User Default Desktop". ## XFCE -XFCE is installed when `base::enable_xfce: true` is set in Hiera. +XFCE is installed when `desktop::enable_xfce: true` is set in Hiera. It then is also used by default with `base::xfce_default: true` or `desktop::session_manager: xfce`. ## IceWM -IceWM is installed when `base::enable_icewm: true` is set in Hiera. +IceWM is installed when `desktop::enable_icewm: true` is set in Hiera. It then is also used by default with `desktop::session_manager: icewm-session`. ## Other (e.g. KDE) diff --git a/admin-guide/configuration/desktop/banner_message.md b/admin-guide/configuration/desktop/banner_message.md index 055e3822..403b3ba9 100644 --- a/admin-guide/configuration/desktop/banner_message.md +++ b/admin-guide/configuration/desktop/banner_message.md @@ -1,9 +1,9 @@ # Banner Message -To show a specific message on the Desktop login screen, use the Hiera key `desktop::banner_message`: +To show a specific message on the Desktop login screen, use the Hiera key `gdm::banner_message`: ``` -desktop::banner_message: 'Good morning, this is a test banner message!' +gdm::banner_message: 'Good morning, this is a test banner message!' ``` Which then looks on RHEL8 like @@ -15,7 +15,4 @@ The default is Please contact the service desk (phone: 4800) in case you have problems logging in. ``` -This is only implemented for `gdm` (default) and not yet for `lightdm` (rarely used at PSI) - - - +As the key suggests this is only implemented for `gdm` (default). diff --git a/admin-guide/configuration/desktop/desktop.md b/admin-guide/configuration/desktop/desktop.md new file mode 100644 index 00000000..25d28636 --- /dev/null +++ b/admin-guide/configuration/desktop/desktop.md @@ -0,0 +1,38 @@ +# 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: + +```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! + +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, ... +``` + +Individual desktops can be enabled/disabled via: +```yaml +desktop::enable_gnome: true # true (default) +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: + +```yaml +desktop::enable_office_apps: false # default: true +``` + +Further refinements can be done as documented in the other guides in this section. + +Finally here a rough overview of the destop_profile structure: +![Structure desktop profile](_static/desktop_profile.svg) +[Structure desktop_profile](_static/desktop_profile.excalidraw) + diff --git a/engineering-guide/puppet/profiles/gnome.rst b/engineering-guide/puppet/profiles/gnome.rst deleted file mode 100644 index 5caf5689..00000000 --- a/engineering-guide/puppet/profiles/gnome.rst +++ /dev/null @@ -1,46 +0,0 @@ -``profile::gnome`` -================== - -This module installs and configures the Gnome desktop environment. - - -Parameters ----------- - -=============================== ======== ================================================ -**Name** **Type** **Default** -------------------------------- -------- ------------------------------------------------ -banner_message string -enable_update_notifications bool -favorites list -keyboard_layouts list -=============================== ======== ================================================ - - -``banner_message`` -~~~~~~~~~~~~~~~~~~ - -The message displayed above the login prompt. - - -``enable_update_notifications`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Whether or not ``gnome-software`` is started at the beginning of a session to -notify the user about available updates. - - -``favorites`` -~~~~~~~~~~~~~ - -The applications/directories/etc to be displayed in the *Favorites* menu and/or -the Gnome dock. Each member of the list must be a string containing the full -name (not path!) of the ``.desktop`` file, eg. ``gnome-terminal.desktop`` for -the Gnome Terminal. - - -``keyboard_layouts`` -~~~~~~~~~~~~~~~~~~~~ - -A list of the keyboard mappings which should be available on the login screen. -The first mapping in the list is the default.