Skip to content

docs: add KDE Plasma autologin session name troubleshooting tip (fixes #624) #7

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

Open
tangzz-radxa wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add KDE Plasma autologin session name troubleshooting tip (fixes #624) #7

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 配置自动登录后若自动登录失败（如卡在登录界面），可能是会话名称配置不一致所致。

具体表现为：当通过 GUI（rsetup → User Settings → Configure auto login）配置后，系统写入的会话名称为 `plasma`，但 KDE Plasma 实际需要的会话名称为 `plasma.desktop`。

若遇到此情况，可手动编辑自动登录配置文件（通常位于 `/etc/lightdm/lightdm.conf.d/kde_settings.conf` 或 SDDM 相关配置），将会话名称修改为 `plasma.desktop`，示例：

```ini
[Autologin]
Session=plasma.desktop
User=radxa
```

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

</TabItem>

</Tabs>
48 changes: 48 additions & 0 deletions docs/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
@@ -0,0 +1,48 @@
You can configure your system to automatically log in without entering the password.

<Tabs>
<TabItem value="Debian 11">
![ROCK5A_Auto_Login](/img/rock5a/rock5a_auto_login_1.webp)

Switch to `Advanced` as shown in the figure, click the box to select the user who is automatically logged in, and then click apply to complete the automatic login setting. Restarting your computer now will no longer require you to enter your login password.

![ROCK5A_Auto_Login](/img/rock5a/rock5a_auto_login_2.webp)

</TabItem>
<TabItem value="Debian 12">

As shown , use `Ctrl + Alt + T` to open the terminal, then enter `rsetup ` and select `User Settings` to configure.

![ROCK5T_Auto_Login](/img/rock5t/rock5t-autologin-1.webp)

:::tip
If the `rsetup` option does not show `Configure auto login`, please use the `System` -> `System Update` option in the `rsetup` tool to update and restart the system.
:::

Select `Configure auto login`,

![ROCK5T_Auto_Login](/img/rock5t/rock5t-autologin-2.webp)

Select `gdm.service` by the space, and then select `OK` to complete the automatic login setup. Now restarting the computer will no longer require you to enter a login password.

![ROCK5T_Auto_Login](/img/rock5t/rock5t-autologin-3.webp)

:::tip KDE Plasma Desktop Autologin Note
If you are using the KDE Plasma desktop and autologin fails after configuring via the rsetup GUI (e.g., the system gets stuck at the login screen), the session name in the configuration may be incorrect.

Specifically, after configuring via the GUI (rsetup → User Settings → Configure auto login), the system writes `plasma` as the session name, but KDE Plasma actually requires `plasma.desktop`.

To fix this, manually edit the autologin config file (usually located at `/etc/lightdm/lightdm.conf.d/kde_settings.conf` or the SDDM config) 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