Skip to content

Installing XLibre (WIP)

RotaryBoot58 edited this page Aug 16, 2025 · 10 revisions

This page will describe how to install, configure and use XLibre on your machine.

Please bear with us that the content here is a work in progress (WIP). If you have any suggestion, advice or want to update something in this page just talk about it.

Installation

Check if your distribution provides the xlibre packages by visiting Are We XLibre Yet?.

If your distribution is in the First-party support list all you have to do is install through your package manager and head to Configuration

In case it is on the Third-party support list, special configuration will be needed depending on your distribution. Visit the repository by clicking in the link aside your Linux distribution and follow the steps to install in your system easily.

My Linux distro is not in any of those lists. What do I do?

Then you will need to build it from source, installing the dependencies manually and following this guide on Building XLibre from source.

Configuration

After installing or building XLibre you will need to configure it.

Please check the Arch Wiki page for a more detailed configuration.

XLibre server needs some components in order to properly work as desired, you can start and even run programs after installing it properly but you wont be able to type or even user your mouse.

Configuring your keyboard and mouse

Keyboard

Install the xlibre-input-libinput module (also called xlibre-xf86-input-libinput)

Mouse

Install the xlibre-input-mouse module (also called xlibre-xf86-input-mouse)

Generic (both keyboard and mouse

Install the xlibre-input-evdev module (also called xlibre-xf86-input-mouse)

Usage

Troubleshooting

Conclusion

Clone this wiki locally