Forge Home


This Puppet module installs and manages plymouth splash screen on client computers.

Louis-Philippe Véronneau



3,840 latest version

5.0 quality score

Version information

  • 2.0.1 (latest)
  • 2.0.0
released Feb 8th 2019
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • Debian

Start using this module

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

Add this declaration to your Puppetfile:

mod 'baldurmen-plymouth', '2.0.1'
Learn more about managing modules with a Puppetfile

Add this module to a Bolt project:

bolt module add baldurmen-plymouth
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install baldurmen-plymouth --version 2.0.1

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.



baldurmen/plymouth — version 2.0.1 Feb 8th 2019



This module makes it easy to manage plymouth on client computers running Linux.

Module Description

There are two main functions to this module:

  • choose whether plymouth should be ran or not
  • choose what plymouth theme will be used

If plymouth installation is set to true, it will automatically configure GRUB to use plymouth.


What plymouth affects

This module starts by installing these two packages:

  • plymouth
  • plymouth-themes

It then replaces the GRUB_CMDLINE_LINUX_DEFAULT="quiet" line in /etc/default/grub with the default GRUB_CMDLINE_LINUX_DEFAULT="quiet splash" in order to add the 'splash' option in the default GRUB boot.

For this change to be effective, the command update-grub2 is ran.

If you instead wish to pass custom parameter to GRUB_CMDLINE_LINUX_DEFAULT you can use the grub_override parameter.

This module also sets the client's default plymouth theme to the chosen theme. By default the theme spinfinity is used if no theme is specified. This is done by running the plymouth-set-default-theme command.

Finally the new initramfs image is created by running the update-initramfs command.


This modules depends on stdlib to run.

This module has three parameters:

  • ensure
  • theme
  • grub_override

You can use this module by calling its class. A more advanced usage would look like:

class { 'plymouth':
  theme         => 'solar',
  grub_override => 'quiet splash nomodeset';


Data type: Enum

The ensure parameter enables or disables plymouth on client computers. It accepts two values, present and absent.

If the parameter is set from present to absent, plymouth and related packages will be uninstalled and the "splash" option will simply be disabled in GRUB.

Default value: present


Data type: String

The theme parameter lets you choose what theme plymouth will use. The following themes are available by default:

  • fade-in: features a centered logo that fades in and out while stars twinkle around the logo during system boot up.
  • glow: features a pie chart as progress indicator.
  • script: features a simple base theme.
  • solar: features a blue flamed sun with animated solar flares.
  • spinfinity: features a centered logo and animated spinner that spins in the shape of an infinity sign.
  • spinner: features a simple theme with a small spinner on a dark background.

Default value: spinfinity


Data type: String

Sometimes you need to pass other parameters to grub than just quiet splash. This is especially true if you still use old monitors and need to set nomodeset.

To do this use the grub_override parameter. Anything given to that parameter will be outputted in GRUB_CMDLINE_LINUX_DEFAULT=.

Default value: undef


This module has been developed for clients using Debian Stretch and Puppet 4.x.


If you want to contribute to this module, please send a pull request. If you find a bug, please submit a bug issue in the tracker.