Forge Home


System serial console setup for SOL


996 latest version

5.0 quality score

Version information

  • 1.1.0 (latest)
  • 1.0.1
  • 1.0.0
  • 0.10.0
released Aug 3rd 2021
This version is compatible with:
  • Puppet Enterprise 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 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
  • Puppet >= 5.5.0 < 8.0.0
  • , , , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'mindhive-serial_console', '1.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add mindhive-serial_console
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install mindhive-serial_console --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.



mindhive/serial_console — version 1.1.0 Aug 3rd 2021

Puppet module for system serial console setup

This module configures system for serial console access (boot loader and kernel), usable through Serial-over-LAN (SOL).


Module has been tested on:

  • Puppet:
    • 5.5
    • 6.14
  • OSes:
    • Ubuntu 18.04
    • Debian 8 - 9
    • RHEL/CentOS 7

Quick Start


include serial_console

Full configuration options:

class { serial_console:
  ensure            => present,  # add or remove configuration
  enable_kernel     => true,     # enable kernel config
  enable_bootloader => true,     # enable bootloader config
  reboot            => false,    # reboot if kernel parameters are changed (SOL won't work until reboot)
  tty               => 'tty0',   # text console name
  ttys              => 'ttyS0',  # serial device name without path, defaults to last ttyS* with a UART 
  speed             => 115200,   # serial port speed
  logout_timeout    => undef,    # interactive session timeout in seconds (sets TMOUT)


serialports, usbserialports

List of available serial port device names (without /dev prefix). For example: