Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Display Manager

Configures the display manager for graphical sessions on desktop and laptop hosts.

Purpose

Provide a consistent, terminal-based login experience via greetd and tuigreet on hosts with a display.

Entry Point

Options

core.display-manager.enable

Typeboolean
Defaultfalse
Exampletrue

Whether to enable display manager configuration.


Architecture / Services / Scope

Enabled by default on hosts where host.device.isHeadless = false. The greetd greeter runs as the greeter user and:

  • shows the current time,
  • remembers the last logged-in user and last selected session, and
  • exposes both Wayland and X11 session directories when services.displayManager.sessionPackages is non-empty.

Greeter cache is persisted to /var/cache/tuigreet through host.persistence.directories.

Operational Notes / Assumptions

  • Both Wayland (wayland-sessions) and X11 (xsessions) session paths are built dynamically from installed session packages, so adding a new session package is enough to make it appear in the greeter.