Forge Home


Install and configure irssi chat client


4,105 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.3 (latest)
  • 0.1.2
  • 0.1.1
  • 0.1.0 (deleted)
released May 24th 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
  • ,

Start using this module

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

Add this module to your Puppetfile:

mod 'brwyatt-irssi', '0.1.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add brwyatt-irssi
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install brwyatt-irssi --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.



brwyatt/irssi — version 0.1.3 May 24th 2019


Build Status

GitHub license GitHub issues GitHub forks GitHub stars

Puppet Forge Puppet Forge - downloads Puppet Forge - scores

Table of Contents

  1. Description
  2. Setup - The basics of getting started with irssi
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. Contributors - List of those who've helped to make the module better


This module provides simple classes and types for installing the irssi chat client on a system, and setting up user configuration and scripts.


What irssi affects

This module installs the irssi package and may optionally be used to manage one or more user configuration directories.

Setup Requirements

Currently, this module only supports Ubuntu (tested on Ubuntu 14.04), but will likely work on otehr Debian-based distributions.

Beginning with irssi

To install this modual, call:

puppet module install brwyatt-irssi


To install irssi on agent, simply include it into your manifests.

include ::irssi




Installs and realizes user configuration for irssi by including irssi::install and irssi::configure.


Realizes user configuration for irssi.

Realizes all irssi::user_config and irssi::user_script resources.


Installs the irssi package with the default system package provider.

Default values for class parameters are derived from Hiera data files in irssi/data/


  • package_ensure: Package ensure value (defaults to "latest")
  • package_name: Name of the package (defaults to "irssi" on Debian)

Defined Types


Manages an irssi config directory and config file.


  • owner: (required) System owner of the files and directories
  • config_dir: (namevar) Path of the config directory to manage
  • networks: Hash of networks and their configurations TODO: Describe structure
  • real_name: Default real name of the user
  • user_name: Default user name of the user
  • nick_name: Default nick name of the user
  • windows: Array of pre-defined windows and their settings TODO: Describe structure
  • purge_scripts: Whether the scripts directory should have unmanaged scripts purged (default: false)


Manages scripts installed in a config directory.


  • config_dir: (required) Config directory this script should be installed to
  • owner: (required) System owner of the script
  • source: Source for the file (required unless content defined)
  • content: Content of the file (required unless source defined)
  • user_config: (optional) Name of the irssi::user_config if named differently than the default config_dir
  • autorun: Controls whether the script should be enabled to auto-load on irssi start. (default: false)
  • script_name: (namevar) The filename for the script file


Currently, this module is only tested against Ubuntu 16.04. It will likely work on other Debian-based distributions, and may or may not work on RedHat-based distributions, but makes no claims regarding such.


Feel free to file issues in the GitHub issue tracker for the repository, or submit Pull Requests.

I may not have much time to work on (or test) this myself, so help to expand current functionality (especially to make it work for more people) is greatly appreciated and encouraged.


The list of contributors can be found at: