Skip to content

docs(common/radxa-os): add KDE Plasma autologin session name troubleshooting tip #1997

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Milir-Radxa merged 1 commit into from
Aug 18, 2026
+32 −0
Merged

docs(common/radxa-os): add KDE Plasma autologin session name troubleshooting tip #1997

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/common/radxa-os/_autologin.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

修改后重启系统即可正常自动登录。
:::

</TabItem>

</Tabs>
16 changes: 16 additions & 0 deletions i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_autologin.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
:::

</TabItem>

</Tabs>
Loading