The wikis are now using the new authentication system.
If you did not migrate your account yet, visit


Jump to: navigation, search
Welcome to the OpenSUSEway Portal Edit
OpenSUSEway Desktop Environment (DE) based on Sway and includes login manager, additional packages, openSUSE branding and themes:
  • greetd with gtkgreet as login manager and greeter to login into the system
  • waybar as status bar
  • Tumbleweed wallpaper
  • Sway#wofi as application launcher
  • alacritty as default terminal
  • mako as notifier
  • wob for the sound and brightness indicator
  • imv as the image viewer
  • mpv as video player
  • vifm as ncurses based file manager

For whom is openSUSEway:

  • who needs full setup of Sway out of the box
  • all the branding and customization preinstalled
If there is will to just try tiling 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 systemctl set-default
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:

  • script installed to the /usr/bin/ 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 issue on github or comment on one: