hyprwm/hyprland-wiki
1
0
Fork 0
mirror of https://github.com/hyprwm/hyprland-wiki.git synced 2026-05-06 23:58:01 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs: note GNOME Keyring PAM setup when launching from tty (#1427)

Browse source 
When bypassing a display manager to launch from a tty, some session
integrations may not be configured. Add a collapsible note about setting
up pam_gnome_keyring.so for automatic keyring unlocking, with an
Arch Linux example and guidance to consult distribution-specific docs.

Co-authored-by: Michel Heily <michel.heily@gmail.com>
This commit is contained in:
MichelOS 2026-04-08 14:01:16 +03:00 • committed by GitHub
parent 2cb810a222
commit efff327bd2
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 23 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
content/Useful Utilities/Systemd-start.md
View file

@ -54,6 +54,29 @@ For more info, read the [option](https://search.nixos.org/options?channel=unstab
### In tty
{{% details title="GNOME Keyring PAM setup" closed="true" %}}
When launching from a tty instead of a display manager, some session integrations that display managers normally handle may not be configured. One common example is [GNOME Keyring](https://wiki.gnome.org/Projects/GnomeKeyring) — if `pam_gnome_keyring.so` is not present in your PAM login configuration, the keyring will not auto-unlock, and applications may prompt you to unlock it manually.
To set this up, add the `pam_gnome_keyring.so` lines to the PAM configuration file used by your login method (e.g. `/etc/pam.d/login` for `login(1)`). Consult your distribution's documentation for the correct file and syntax. For example, on Arch Linux:
```ini {hl_lines=[5,8,10]}
#%PAM-1.0
auth requisite pam_nologin.so
auth include system-local-login
-auth optional pam_gnome_keyring.so
account include system-local-login
password include system-local-login
-password optional pam_gnome_keyring.so use_authtok
session include system-local-login
-session optional pam_gnome_keyring.so auto_start
```
Display managers (GDM, SDDM, etc.) typically include this PAM configuration already. This step is only needed for console-based (tty) login.
{{% /details %}}
To launch Hyprland with uwsm, add this code in your shell profile.
```