Jump to: navigation, search
Welcome to the OpenSUSEway Portal Edit
OpenSUSEway Desktop Environment (DE) is based on Sway and includes login manager, additional packages, openSUSE branding and themes:

OpenSUSEway is for those who:

  • need full setup of Sway out of the box
  • want all the branding and customization preinstalled
If one just wants to try a tiling window manager, the better way is to setup Sway.
Installation Edit
Currently only Tumbleweed is supported.

Install from the command line:

sudo zypper in openSUSEway

Install from the browser:

  • openSUSE Factory Button-oci.png

After installation, just run


from the command line, or if there is a login manager that supports wayland sessions, it will be available as the session selection.

To enable greetd as default login manager:

sudo mv /etc/greetd/config.toml /etc/greetd/config.toml.org
sudo mv /etc/greetd/config.toml.way /etc/greetd/config.toml
sudo systemctl set-default graphical.target
sudo systemctl enable greetd

If you already have Display Manager (GDM, SDDM, LightDM), you would need to disable it first:

sudo systemctl disable display-manager
sudo systemctl enable greetd

To re-enable your default Display Manager:

sudo systemctl disable greetd
sudo systemctl enable display-manager

openSUSEway is also available in the installer:

  • select basic desktop or server
  • on the last stage, select Software
  • deselect unneeded X and basic icewm if they are selected
  • select openSUSEway
Configuration Edit
Sway configuration

openSUSEway customizes standard Sway config and stores it here by default:


If there is a need to slightly modify and add some options, the best way is to create directories in your local .config directory and add your file there:

mkdir -p ~/.config/sway/config.d/
$EDITOR ~/.config/sway/config.d/my_config_file

Add your changes there, for example:

output eDP-1 scale 1

File `/etc/sway/config` should already have:

include ~/.config/sway/config.d/*

if it doesn't just add it.

After config reload changes should be applied.

If there is a need to customize it more, just create your own files under ~/.config/sway/* they have higher priority then those in /etc/sway/* so local user configuration would be loaded.


openSUSEway installs Environment variables to the /etc/sway/env to cover both tty login and systemd based login managers:

  • sway-run.sh script installed to the /usr/bin/sway-run.sh and it is wrapper script to import environment
  • desktop file installed to /usr/share/wayland-sessions/sway.desktop and it points to the. Original file moved to /usr/share/wayland-sessions/sway.desktop.orig
  • service file /usr/lib/systemd/system/sway.service to run sway as service and it also has section to import environment from the file

For example there is QT_QPA_PLATFORMTHEME=qt5ct that controls QT theme.


openSUSEway forces GTK and QT themes.

GTK is forced in Sway config file 50-openSUSE.conf with gsettings set org.gnome.desktop.interface gtk-theme 'Adwaita-dark'.

QT theme is controlled by settings in /etc/xdg/qt5ct/qt5ct.conf and forcing QT_QPA_PLATFORMTHEME=qt5ct environment. qt5ct.conf got copied to the local user config and would have preference if user reconfigures the theme later.

Sway openSUSE 15.2.png

Default desktop

Open an issue on Github or comment on one:

Discuss the project and ask for support on: