Install the Sway Compositor

Install the Sway Compositor

To install the wayland session, follow these steps:

  1. Install the regolith-session-sway package and its dependencies, which include Regolith’s build of Sway (sway-regolith):

    sudo apt install regolith-session-sway
  2. Log out, or reboot.

  3. Select the “Regolith / Wayland” session in the login panel. In GDM, select your user and choose the session from the gear button in the lower-right corner.

    The GDM login screen with the session menu open from the gear button, and Regolith / Wayland selected

The X11 session (“Regolith / X11”) stays installed, and you can choose either session at each login.

Debian 12 (Bookworm) has the X11 session only. The Wayland session needs Debian 13 (Trixie) or a supported Ubuntu release.

Hardware Support

Those using proprietary nvidia drivers for their graphics cards must set regolith.sway.unsupported_gpu: true in ~/.config/regolith3/Xresources. This is not an issue with the open source drivers nouveau. See more here.

Bar Changes

The wayland session uses i3status-rs rather than i3xrocks. i3status-rs provides a crisper and more resource-efficient approach to system monitoring. However at this time the i3xrocks packages for status indicators are not integrated with i3status-rs. To use a custom configuration with i3status-rs, copy the default configuration to a location of your choosing and set wm.bar.status_config to the path of your copy in ~/.config/regolith3/Xresources:

mkdir -p ~/.config/regolith3/i3status-rust
cp /etc/regolith/i3status-rust/config.toml ~/.config/regolith3/i3status-rust/config.toml
echo "wm.bar.status_config: ~/.config/regolith3/i3status-rust/config.toml" >> ~/.config/regolith3/Xresources

Then edit the copy, and run regolith-look refresh or log back in. See the upstream project documentation for further details.

Last updated on