Forge Home


This module provides simple installation/setup of Xorg


1,210 latest version

5.0 quality score

Version information

  • 1.1.0 (latest)
  • 1.0.0
released Jan 12th 2020
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • Archlinux

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'paulwalkeruk-xorg', '1.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add paulwalkeruk-xorg
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install paulwalkeruk-xorg --version 1.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



paulwalkeruk/xorg — version 1.1.0 Jan 12th 2020


Table of Contents

  1. Description
  2. Setup - The basics of getting started with xorg
  3. Usage - Configuration options and additional functionality
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module


This module provides a simple setup of Xorg. At the moment, it only installs Xorg Server and provides an option for specifying the keyboard layout.


What xorg affects

The following packages will be installed:

  • xorg-server

If the keyboard layout is specified (via the keyboard_layout parameter), then the following packages will also be installed:

  • libxkbcommon

Beginning with xorg

To install Xorg server, you only need:

include xorg


To just install Xorg server, you only need:

include xorg

To set the keyboard layout, use the keyboard_layout parameter. This controls the layout as described in For example, to set it to GB (UK):

class { 'xorg' :
  keyboard_layout => 'gb',


This has been designed for and tested on Arch Linux.


Pull requests are welcome.