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

puppet module install baldurmen-plymouth --version 2.0.0




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.