From 5786862dd7c66f6ffe7a050ceba1b00f3e7323fb Mon Sep 17 00:00:00 2001 From: Tang Zaozao Date: Fri, 14 Aug 2026 05:26:14 +0800 Subject: [PATCH] docs(common/radxa-os): add KDE Plasma autologin session name troubleshooting tip Issue #624: on KDE Plasma desktop, autologin configured via rsetup GUI may fail (stuck at login screen) because the session name is written as 'plasma' instead of the required 'plasma.desktop'. Add a troubleshooting tip in the Debian 12 tab of the autologin page explaining the symptom, cause, and manual fix (edit /etc/sddm.conf.d/kde_settings.conf). Bilingual: zh + en updated together. --- docs/common/radxa-os/_autologin.mdx | 16 ++++++++++++++++ .../current/common/radxa-os/_autologin.mdx | 16 ++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/docs/common/radxa-os/_autologin.mdx b/docs/common/radxa-os/_autologin.mdx index 4b2791d3a..9ae5486ca 100644 --- a/docs/common/radxa-os/_autologin.mdx +++ b/docs/common/radxa-os/_autologin.mdx @@ -29,6 +29,22 @@ ![ROCK5T_Auto_Login](/img/rock5t/rock5t-autologin-3.webp) +:::tip KDE Plasma 桌面自动登录注意事项 +若您使用的是 KDE Plasma 桌面，通过 `rsetup` 的 GUI 完成自动登录配置后，自动登录仍可能失效（例如重启后卡在登录界面）。 + +这通常是因为配置中写入的会话名称为 `plasma`，而 KDE Plasma 实际需要的会话名称为 `plasma.desktop`。 + +可手动编辑自动登录配置文件（KDE Plasma 通常使用 SDDM，配置文件一般位于 `/etc/sddm.conf.d/kde_settings.conf`），将会话名称修改为 `plasma.desktop`，示例： + +```ini +[Autologin] +Session=plasma.desktop +User=radxa +``` + +修改后重启系统即可正常自动登录。 +::: + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_autologin.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_autologin.mdx index 0577cf839..a1e552ec8 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_autologin.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_autologin.mdx @@ -29,6 +29,22 @@ Select `gdm.service` by the space, and then select `OK` to complete the automati ![ROCK5T_Auto_Login](/img/rock5t/rock5t-autologin-3.webp) +:::tip KDE Plasma Desktop Autologin Note +If you are using the KDE Plasma desktop, autologin may still fail after configuring it via the `rsetup` GUI (e.g. the system gets stuck at the login screen after reboot). + +This is usually caused by the session name being written as `plasma`, while KDE Plasma actually requires `plasma.desktop`. + +Manually edit the autologin configuration file (KDE Plasma typically uses SDDM, and the config file is usually located at `/etc/sddm.conf.d/kde_settings.conf`) and change the session name to `plasma.desktop`, for example: + +```ini +[Autologin] +Session=plasma.desktop +User=radxa +``` + +After editing, restart the system — autologin should work normally. +::: +