Weston is the reference implementation of a Wayland compositor also developed by the Wayland project. It is written in C and published under the MIT License. Weston only has official support for the Linux operating system due to its dependence on certain features of the Linux kernel, such as kernel mode-setting, Graphics Execution Manager (GEM), and udev, which have not been implemented in other Unix-like operating systems.


Weston is a lightweight and functional Wayland compositor.


Global Installation

User Profile Installation

To install weston, run:

$ guix package -i weston

Starting the desktop

From terminal

To launch weston, we need to set a number of environment variables:

$ export XDG_RUNTIME_DIR=/tmp/${UID}-runtime-dir
$ /tmp/0-runtime-dir
$ mkdir "${XDG_RUNTIME_DIR}"
$ chmod 0700 "${XDG_RUNTIME_DIR}"

Now launch weston:

$ weston-launch

Graphical login


Use a different window manager


Set-up environment variables

Editing the Application Menu


Desktop icons are grouped together

Tips and tricks

Customizing Leave

See also

PantherX & (unofficial) GuixSD Wiki.

Last update: 2020-02-19 21:18:01 +0000

Inspired by the excellent Arch Linux Wiki