Skip to content

Commit 51af4c1

Browse files
committed
Automatic documentation update
1 parent 93ccd47 commit 51af4c1

File tree

1 file changed

+45
-4
lines changed

1 file changed

+45
-4
lines changed

docs/User-Guide_Armbian-Config/System.md

Lines changed: 45 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -220,10 +220,48 @@ armbian-config --cmd BOOT01
220220
~~~
221221

222222

223-
## Install, remove and configure desktop environments
223+
## Desktop
224224

225-
__Edit:__ [footer](https://github.com/armbian/configng/new/main/tools/include/markdown/Desktops-footer.md) [header](https://github.com/armbian/configng/new/main/tools/include/markdown/Desktops-header.md)
226-
#### Gnome desktop
225+
226+
Install, remove and configure desktop environments
227+
228+
229+
<!--- header START from tools/include/markdown/Desktops-header.md --->
230+
Armbian desktop installation uses upstream meta-packages from Debian and Ubuntu repositories, making it distro-agnostic and independent of pre-built Armbian desktop packages.
231+
232+
**How it works:**
233+
234+
- Installs the desktop environment meta-package (e.g., `xfce4`, `gnome-session`) along with essential extras
235+
- Tracks all newly installed packages so uninstall cleanly removes everything added on top of CLI, including dependencies
236+
- Applies Armbian branding: wallpapers, icons, login screen theme, and default user settings
237+
- Configures the display manager (LightDM, GDM3, or SDDM) with auto-login
238+
- Installs Armbian Imager as an AppImage for writing OS images
239+
- Sets up Profile Sync Daemon (psd) to keep browser profiles in RAM, reducing flash media wear
240+
- Removes unnecessary bloat pulled in by meta-packages
241+
242+
**Networking:**
243+
244+
Desktop environments that require NetworkManager (e.g., GNOME) install it alongside the existing `systemd-networkd`. Wired Ethernet interfaces remain managed by `systemd-networkd`, while NetworkManager handles WiFi and VPN connections. This avoids disrupting existing network configuration.
245+
246+
**Supported desktops:**
247+
248+
| Desktop | Best for | Resources |
249+
|---|---|---|
250+
| XFCE | Single board computers, low-end hardware | ~300 MB RAM |
251+
| GNOME | Modern desktops, touchscreen devices | ~800 MB RAM |
252+
| Cinnamon | Users familiar with Windows layout | ~500 MB RAM |
253+
254+
!!! note "Switching desktops"
255+
256+
Only one desktop environment should be installed at a time. Remove the current desktop before installing a different one to avoid package conflicts and mixed configurations.
257+
258+
<!--- header STOP from tools/include/markdown/Desktops-header.md --->
259+
260+
__Edit:__ [footer](https://github.com/armbian/configng/new/main/tools/include/markdown/Desktops-footer.md) [header](https://github.com/armbian/configng/edit/main/tools/include/markdown/Desktops-header.md)
261+
#### GNOME
262+
263+
264+
GNOME - modern, full-featured desktop
227265

228266
__Edit:__ [footer](https://github.com/armbian/configng/new/main/tools/include/markdown/GNOMDE-footer.md) [header](https://github.com/armbian/configng/new/main/tools/include/markdown/GNOMDE-header.md)
229267
###### Gnome desktop Install
@@ -287,7 +325,10 @@ armbian-config --cmd GNME04
287325

288326

289327

290-
#### XFCE desktop
328+
#### XFCE
329+
330+
331+
XFCE - lightweight and fast desktop
291332

292333
__Edit:__ [footer](https://github.com/armbian/configng/new/main/tools/include/markdown/XFCEDE-footer.md) [header](https://github.com/armbian/configng/new/main/tools/include/markdown/XFCEDE-header.md)
293334
###### XFCE desktop Install

0 commit comments

Comments
 (0)