Forge Home


small modules to install grub


5,560 latest version

4.6 quality score

Version information

  • 0.1.3 (latest)
  • 0.1.2
  • 0.1.0
released Apr 18th 2018
This version is compatible with:

Start using this module

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

Add this module to your Puppetfile:

mod 'icann-grub', '0.1.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add icann-grub
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install icann-grub --version 0.1.3

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.



icann/grub — version 0.1.3 Apr 18th 2018

Build Status Puppet Forge Puppet Forge Downloads


Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with grub
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module


This module installs is used to manage grub, specificly we wanted a way to secure the grub menu entry which i did not find at the time. In future we will look to migrate to herculesteam-augeasproviders_grub


What grub affects

  • Manages the grub menu item and superusers

Setup Requirements

  • puppetlabs-stdlib 4.12.0

Beginning with grub

just add the grub class.

class {'::grub' }


Add an user and password and protectect edit functions

class {'::grub' 
  user => 'test',
  password => grub.pbkdf2.sha512.10000.$SOMHEHASH,

of with hiera

grub::user: test
grup::password: grub.pbkdf2.sha512.10000.$SOMHEHASH



Public Classes

Class: grub

Main class, includes all other classes

  • user (Optional[String]): The user to secure grub. If the username and password are present then by default they will be required to edit grub config at boot
  • password (Optional[String]): The password to secure grub
  • protect_boot (Boolean, Default: false): If true also require the username and password toboot the system
  • protect_advanced (Boolean, Default: false): If true also require the username and password to access the advanced menu


This module is tested on Ubuntu 14.04, and 16.04