Tested with Travis CI

Table of Contents

  1. Description

  2. Setup - The basics of getting started with oddjob

  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


This module manages oddjob, a D-Bus service which performs random tasks.


What oddjob affects

This module installs and manages the oddjob D-Bus service and the mkhomedir oddjob helper.

Beginning with oddjob

In the very simplest case, you can just include the following:

include ::dbus
include ::oddjob


To install the mkhomedir Oddjob job:

include ::dbus
include ::oddjob
include ::oddjob::mkhomedir

You will then likely want to configure the PAM stack to utilise this.


The reference documentation is generated with puppet-strings and the latest version of the documentation is hosted at bodgit.github.io/puppet-oddjob/.


This module has been built on and tested against Puppet 4.4.0 and higher.

The module has been tested on:

  • RedHat Enterprise Linux 6/7


The module has both rspec-puppet and beaker-rspec tests. Run them with:

$ bundle exec rake test
$ PUPPET_INSTALL_TYPE=agent PUPPET_INSTALL_VERSION=x.y.z bundle exec rake beaker:<nodeset>

Please log issues or pull requests at github.